Plan Create Stories
coleam00/skills
Decomposes a PRD into well-formed, engineer-ready tickets — Jira issues or GitHub issues.
Create user stories with duplicate checking across any project tracker (Linear, GitHub Issues, Jira)
Install Create User Story
$ npx skills add huytieu/COG-second-brain --skill create-user-story -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install huytieu/COG-second-brain create-user-story --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/create-user-story .claude/skills/create-user-story && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "create-user-story" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/create-user-story into .claude/skills/create-user-story/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-user-story", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/huytieu/COG-second-brain/tree/main/skills/create-user-storyType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add huytieu/COG-second-brain --skill create-user-story -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install huytieu/COG-second-brain create-user-story --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/create-user-story .agents/skills/create-user-story && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "create-user-story" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/create-user-story into .agents/skills/create-user-story/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-user-story", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add huytieu/COG-second-brain --skill create-user-story -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install huytieu/COG-second-brain create-user-story --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/create-user-story .cursor/skills/create-user-story && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "create-user-story" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/create-user-story into .cursor/skills/create-user-story/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-user-story", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/huytieu/COG-second-brain.git --path skills/create-user-story--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add huytieu/COG-second-brain --skill create-user-story -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install huytieu/COG-second-brain create-user-story --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/create-user-story .gemini/skills/create-user-story && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "create-user-story" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/create-user-story into .gemini/skills/create-user-story/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-user-story", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install huytieu/COG-second-brain create-user-storyInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add huytieu/COG-second-brain --skill create-user-story -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/create-user-story .github/skills/create-user-story && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "create-user-story" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/create-user-story into .github/skills/create-user-story/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-user-story", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add huytieu/COG-second-brain --skill create-user-story -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install huytieu/COG-second-brain create-user-story --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/create-user-story .opencode/skills/create-user-story && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "create-user-story" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/create-user-story into .opencode/skills/create-user-story/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-user-story", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
create-user-story- GitHub stars
- 1.3k
- Token cost
- ~2k tokens
- SKILL.md length
- 543 words
- Files
- 1
- Skills in repo
- 37
- Repo updated
- First seen
- Licence
- MIT
At a glance
Create user stories with duplicate checking across any project tracker (Linear, GitHub Issues, Jira)
- Works in 6 steps: Understand the Request → Duplicate Check → Report Duplicates (if found) → …
- Tasks that involve User stories
- SKILL.md covers When to Invoke, Agent Mode Awareness, Command: /create-user-story and Pre-Flight Check, plus 3 more sections
- Calls gh
What it does
Create User Story is an agent skill from huytieu/COG-second-brain. Create user stories with duplicate checking across any project tracker (Linear, GitHub Issues, Jira)
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Product & Project Management, covering User stories. It works with GitHub and Jira. The repository describes itself as: Self-evolving second brain with 35 AI skills, 10 agents, and people CRM. Closed-loop harness: a V-model verification lifecycle where the worker never grades its own homework… The licence is MIT.
When your agent uses it
- Tasks that involve User stories
Example prompts
- “/create-user-story”
Workflow steps
6 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 36ac9d7. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
gh
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Create User Story loads about 2k tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 543 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from huytieu/COG-second-brain at commit 36ac9d7, republished under its MIT licence (© huytieu). 543 words, ~1,967 tokens.
Download SKILL.mdSave it as
.claude/skills/create-user-story/SKILL.md (or your agent's skills folder).- name
- create-user-story
- description
- Create user stories with duplicate checking across any project tracker (Linear, GitHub Issues, Jira)
- roles
- product-manager, engineering-lead, founder
- integrations
- linear, github, jira
COG Create User Story Skill
When to Invoke
- User wants to create a new user story, feature request, or issue
- User says "create story", "new story", "add issue", "write user story", "create ticket"
- User describes a feature or requirement that should be tracked
Agent Mode Awareness
Check agent_mode in 00-inbox/MY-PROFILE.md frontmatter:
- If
agent_mode: team— use parallel agents to check for duplicates across all active trackers simultaneously, then create the story - If
agent_mode: solo— check duplicates and create the story sequentially in the main conversation
Command: /create-user-story
Pre-Flight Check
Read
00-inbox/MY-INTEGRATIONS.mdto determine which project trackers are active:- Linear — use Linear MCP tools
- GitHub — use
ghCLI - Jira — use
jiraCLI or Jira API via WebFetch - If NO tracker is active, save the story as a markdown file in
04-projects/[project]/stories/and inform the user
Read
00-inbox/MY-PROFILE.mdto get:- Active projects (to determine which project/repo/board to target)
- User's name (for story author attribution)
Ask the user (if not already provided):
- What is the feature or requirement? (free-form description)
- Which project does this belong to? (if multiple active projects)
- Priority level? (optional — default to medium)
Execution Strategy
Phase 1: Understand the Request
Parse the user's input to extract:
- Feature description — what the user wants built
- Target users — who benefits from this
- Problem statement — what problem this solves
- Project context — which project this belongs to
If the user provides a brief description, ask clarifying questions before proceeding:
- Who is the target user for this feature?
- What problem does this solve?
- Are there any specific acceptance criteria you have in mind?
Phase 2: Duplicate Check
CRITICAL: Always check for duplicates before creating.
Team Mode (parallel agents)
Launch duplicate-check agents in parallel using the Task tool with run_in_background: true:
Agent: "duplicate-checker-linear" (if Linear is active)
Search Linear for potential duplicate issues.
1. Use ToolSearch to load Linear tools
2. Use mcp__claude_ai_Linear_2__list_issues to search for issues with similar keywords
3. Search across all active projects/teams
4. Return any issues that match by title similarity or description overlap
Search terms: [extracted keywords from user's description]
Return: list of potential duplicates with title, status, URL, and similarity assessmentAgent: "duplicate-checker-github" (if GitHub is active)
Search GitHub Issues for potential duplicates.
Repository: [CUSTOMIZE: your-org/your-repo]
1. gh search issues "[keywords]" --repo [CUSTOMIZE: your-org/your-repo] --json number,title,state,url,body --limit 20
2. Also search closed issues to check if this was already done:
gh search issues "[keywords]" --repo [CUSTOMIZE: your-org/your-repo] --state closed --json number,title,state,url --limit 10
Return: list of potential duplicates with title, status, URL, and similarity assessmentAgent: "duplicate-checker-jira" (if Jira is active)
Search Jira for potential duplicate issues.
Project: [CUSTOMIZE: YOUR-PROJECT-KEY]
1. Use WebFetch or jira CLI to search:
JQL: project = "[CUSTOMIZE: YOUR-PROJECT-KEY]" AND text ~ "[keywords]" ORDER BY created DESC
2. Check both open and recently resolved issues
Return: list of potential duplicates with key, title, status, URL, and similarity assessmentSolo Mode (sequential)
Run the same duplicate checks sequentially for whichever tracker is active.
Phase 3: Report Duplicates (if found)
If potential duplicates are found, present them to the user:
I found [N] potential duplicate(s):
1. **[TITLE]** ([STATUS]) — [URL]
Similarity: [High/Medium/Low] — [reason]
2. **[TITLE]** ([STATUS]) — [URL]
Similarity: [High/Medium/Low] — [reason]
Options:
a) These are different — proceed with creating the new story
b) This is a duplicate of #[N] — skip creation
c) This is related to #[N] — create and link themWait for user confirmation before proceeding.
Show full SKILL.md (214 more words)Show less
Phase 4: Format the User Story
Generate the story in standard user story format:
## Title
[Concise, descriptive title]
## User Story
**As a** [type of user],
**I want** [goal/desire],
**So that** [benefit/value].
## Description
[Expanded description of the feature, including context and background]
## Acceptance Criteria
### Scenario 1: [Happy path scenario name]
- **Given** [precondition]
- **When** [action]
- **Then** [expected outcome]
### Scenario 2: [Alternative scenario name]
- **Given** [precondition]
- **When** [action]
- **Then** [expected outcome]
### Scenario 3: [Edge case or error scenario name]
- **Given** [precondition]
- **When** [action]
- **Then** [expected outcome]
## Technical Notes
[Any implementation hints, constraints, or dependencies — if applicable]
## Out of Scope
[What this story explicitly does NOT cover — helps prevent scope creep]Present the formatted story to the user for review before creating it.
Phase 5: Create in Tracker
After user approves the story content:
Linear
1. Use ToolSearch to load Linear tools
2. Use mcp__claude_ai_Linear_2__get_team to find the target team
3. Use mcp__claude_ai_Linear_2__list_issue_labels to find appropriate labels
4. Use mcp__claude_ai_Linear_2__save_issue to create the issue with:
- title: [story title]
- description: [full story in markdown]
- team: [target team]
- priority: [user-specified or default medium]
- labels: [appropriate labels]GitHub Issues
gh issue create \
--repo [CUSTOMIZE: your-org/your-repo] \
--title "[story title]" \
--body "[full story in markdown]" \
--label "[appropriate labels]"Jira
Use WebFetch to POST to Jira REST API or use jira CLI:
- Project: [CUSTOMIZE: YOUR-PROJECT-KEY]
- Issue Type: Story
- Summary: [story title]
- Description: [full story in markdown/Jira wiki format]
- Priority: [user-specified or default Medium]
- Labels: [appropriate labels]Vault Fallback (no tracker active)
Save to 04-projects/[project]/stories/story-YYYY-MM-DD-[slug].md
Phase 6: Confirm and Link
Confirm creation with the user:
Story created: **[TITLE]** [URL or file path] Priority: [priority] Labels: [labels]If the user indicated this is related to another issue (Phase 3, option c), create a link/relation between them.
Also save a local copy to
04-projects/[project]/stories/for vault reference.
Fallback Behavior
| Scenario | Behavior |
|---|---|
| No tracker active | Save as markdown in 04-projects/[project]/stories/ |
| Tracker API fails | Save locally, warn user, suggest manual creation with the formatted content |
| Duplicate check fails | Warn user that duplicate check was skipped, proceed with creation after confirmation |
| User doesn't specify project | List active projects from MY-PROFILE.md and ask which one |
| User provides minimal input | Ask clarifying questions to build a complete story |
Error Handling
- API rate limits: Wait and retry once, then fall back to local save
- Authentication failures: Inform user their integration may need re-authentication
- Large search results: Limit duplicate check to top 10 most relevant matches
- Context overflow: Summarize duplicate results rather than showing full descriptions
© huytieu, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/create-user-story of huytieu/COG-second-brain.
Open the folder on GitHubat commit 36ac9d7
Compare with similar skills
Create User Story next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Create User Story this skillhuytieu/COG-second-brain | 1.3k | — | ~2k | Automated safety check: Pass | MIT | |
| Plan Create Storiescoleam00/skills | 676 | — | ~922 | Automated safety check: Pass | MIT | |
| Project Managementseb1n/awesome-ai-agent-skills | 206 | — | ~2.7k | Automated safety check: Pass | MIT | |
| Create Issuetradingstrategy-ai/frontend | 150 | — | ~607 | Automated safety check: Pass | None | |
| Jira CLICode-and-Sorts/awesome-copilot-agents | 580 | 1 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Specgetsentry/sentry-react-native | 1.8k | — | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
Project Management
seb1n/awesome-ai-agent-skills
Manages software projects end-to-end — decomposing work into tasks, tracking progress across sprints, generating status reports, and integrating with tools like Jira, Linear, GitHub Issues, and…
Create Issue
tradingstrategy-ai/frontend
Creates a new GitHub issue with structured user story format, acceptance criteria, and project integration.
Jira CLI
Code-and-Sorts/awesome-copilot-agents
Interact with Jira from the command line to create, list, view, edit, and transition issues, manage sprints and epics, and perform common Jira workflows.
- Official
Spec
getsentry/sentry-react-native
Produce a verified spec — problem, desired outcome, and acceptance criteria — before building.
Abo Issue Watcher
jeeftor/audiobook-organizer
Inspect Audiobook Organizer GitHub issues, comments, acceptance criteria, linked PRs, and next steps.
More from huytieu/COG-second-brain
All 37 skills in this repoVoice Baseline
huytieu/COG-second-brain
Measure your own writing corpus for the words and sentence shapes you over-use, so an agent writing in your voice stops amplifying your tics into a style.
Daily Journal
huytieu/COG-second-brain
A passive daily work journal that Claude keeps FOR you so you never have to write it yourself.
Editorial Illustrations
huytieu/COG-second-brain
Generate meaning-carrying editorial data-illustrations in the monotykamary / Linear aesthetic (near-black grayscale, Inter display + mono labels, hairline framed figures) with a single coral accent.
Loop Engineering
huytieu/COG-second-brain
Shared loop-engineering reference for COG skills - the agent loop, deterministic verifiers, termination conditions, in-loop context management, and named patterns.
Release Video
huytieu/COG-second-brain
Turn a product release (the list of shipped items plus real screen recordings) into a motion recap video and one explained demo per feature, with sound effects tied to on-screen motion and a…
Onboarding
huytieu/COG-second-brain
Personalize COG for your workflow - creates profile, interests, and watchlist files with guided setup (run this first!)
Related
Categories
Questions about Create User Story
What does Create User Story do?
Create user stories with duplicate checking across any project tracker (Linear, GitHub Issues, Jira). Create User Story is an agent skill from huytieu/COG-second-brain.
When should I use Create User Story?
Create User Story fits situations like: tasks that involve User stories.
How do I install Create User Story in Claude Code?
Run `npx skills add huytieu/COG-second-brain --skill create-user-story -a claude-code`. Or copy the skill folder (skills/create-user-story in huytieu/COG-second-brain) into .claude/skills/create-user-story in your project. Claude Code loads it when a task matches its description.
How do I install Create User Story in Codex?
Run `npx skills add huytieu/COG-second-brain --skill create-user-story -a codex`. Or copy the skill folder (skills/create-user-story in huytieu/COG-second-brain) into .agents/skills/create-user-story in your project. Codex loads it when a task matches its description.
Can I use Create User Story in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add huytieu/COG-second-brain --skill create-user-story -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-user-story, .gemini/skills/create-user-story, .github/skills/create-user-story and .opencode/skills/create-user-story in your project.
What does Create User Story need to run?
Going by SKILL.md and its folder, Create User Story needs the command-line tools its instructions call (gh).
Does Create User Story access the network?
SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Create User Story safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Create User Story use?
Create User Story is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Create User Story use?
About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Create User Story?
Skills that share tags, products or a category with Create User Story: Plan Create Stories (coleam00/skills, 676 stars), Project Management (seb1n/awesome-ai-agent-skills, 206 stars), Create Issue (tradingstrategy-ai/frontend, 150 stars) and Jira CLI (Code-and-Sorts/awesome-copilot-agents, 580 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Create User Story?
huytieu (a GitHub user) maintains it in huytieu/COG-second-brain, which has 1,268 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 2, 2026.
Source: huytieu/COG-second-brain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.