User Story
Create user stories with Mike Cohn format and Gherkin acceptance criteria. Use when turning user needs into development-ready work with clear outcomes and testable conditions.
Install
npx skills add deanpeters/Product-Manager-Skills --skill user-storygit clone --depth 1 https://github.com/deanpeters/Product-Manager-Skills.git /tmp/Product-Manager-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Product-Manager-Skills/skills/user-story ~/.claude/skills/user-storyPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
## Purpose Create clear, concise user stories that combine Mike Cohn's user story format with Gherkin-style acceptance criteria. Use this to translate user needs into actionable development work that focuses on outcomes, ensures shared understanding between product and engineering, and provides testable success criteria. This is not a feature spec—it's a conversation starter that captures *who* benefits, *what* they're trying to do, *why* it matters, and *how* you'll know it works. ## Input **Works best with:** The feature or user need the story captures. **Also useful:** The user role, the outcome they want, and edge cases the acceptance criteria must cover. Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended `ARGUMENTS:` line — counts as answers already given. Use it and skip whatever it covers; don't re-ask. **Arriving empty-handed? That works too.** The skill asks who the user is and what they're trying to accomplish before drafting story and Gherkin criteria. **Example invocation:** `Write user stories for password reset via SMS for our banking app — include the lockout edge case.` ## Key Concepts ### The Mike Cohn + Gherkin Format A user story combines: **Use Case (Mike Cohn format):** - **As a** [user persona/role] - **I want to** [action to achieve outcome] - **so that** [desired outcome] **Acceptance Criteria (Gherkin format):** - **Scenario:** [Brief description of the scenario]
Details
- Skill name
user-story- Repository
- deanpeters/Product-Manager-Skills
- Path
skills/user-story/SKILL.md- Repo updated
- 16 October 2026
FAQ
What does the User Story skill do?
Create user stories with Mike Cohn format and Gherkin acceptance criteria. Use when turning user needs into development-ready work with clear outcomes and testable conditions.
How do I install the User Story skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add deanpeters/Product-Manager-Skills --skill user-story. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is User Story popular?
It lives in deanpeters/Product-Manager-Skills, which has 7,800 GitHub stars and 940 forks, and is included in 3 curated skill lists.
Related skills
Acquisition Channel Advisor
7.8kdeanpeters/Product-Manager-Skills
Evaluate acquisition channels using unit economics, customer quality, and scalability. Use when deciding whether to scale, test, or kill a growth channel.
AI Shaped Readiness Advisor
7.8kdeanpeters/Product-Manager-Skills
Assess whether your product work is AI-first or AI-shaped. Use when evaluating AI maturity and choosing the next team capability to build.
Altitude Horizon Framework
7.8kdeanpeters/Product-Manager-Skills
Understand the PM-to-Director transition through altitude and horizon thinking. Use when diagnosing scope, time-horizon, or leadership-level gaps.
User Story Mapping
7.8kdeanpeters/Product-Manager-Skills
Create a user story map that lays out activities, steps, tasks, and release slices. Use when planning a workflow, backlog, or MVP around the user journey.
Storyboard
7.8kdeanpeters/Product-Manager-Skills
Create a six-frame storyboard that shows a user's journey from problem to solution. Use when you need a fast narrative for alignment, concept reviews, or demos.
User Story Mapping Workshop
7.8kdeanpeters/Product-Manager-Skills
Run a user story mapping workshop with adaptive questions and a structured map output. Use when you need backbone activities, tasks, and release slices for a workflow.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.