Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

user-story — Claude Code skill: what it does, how to install

Turns product requirements into Mike Cohn user stories paired with Gherkin acceptance criteria. Fits backlog refinement and sprint planning.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add deanpeters/Product-Manager-Skills --skill user-story -a claude-code
Open on GitHub

What user-story does

This skill converts feature ideas and PRD snippets into Mike Cohn user stories. It maps out who benefits, what action they take, and why it matters, avoiding vague requests or premature technical specifications. If you supply zero background details, the agent queries for the target persona and objective before generating Markdown.

Acceptance criteria follow Gherkin syntax with Given, When, and Then clauses. While preconditions can stack with multiple Givens, the workflow restricts scenarios to a single When and a single Then. Multiple triggers or outcomes signal scope creep and require story splitting. A local deterministic generator is included via python3 scripts/user-story-template.py.

Do not point this skill at database refactoring or internal engineering debt, because it strictly requires direct user-facing value.

What it helps with

  • translate PRD requirements into structured user stories
  • write testable Gherkin acceptance criteria for QA engineers
  • spot oversized stories through multiple When or Then statements
  • align product managers and developers before sprint planning

Example prompts for the agent

  • Write a user story for SMS password reset in our banking app, including lockout edge cases.
  • Convert this PRD export requirement into a user story with Gherkin acceptance criteria.

How to install user-story

1Skills CLI (Vercel)

npx skills add deanpeters/Product-Manager-Skills --skill user-story -a claude-code

2Manually: put the files in place

~/.claude/skills/user-story/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/user-story/

From the same set7

The whole set →
prd-development deanpeters Guides you through writing a structured PRD from discovery notes and user research for engineering handoff. Best for major product initiatives. Claude Code CX Codex Cursor +1 4,700installs roadmap-planning deanpeters Turns scattered feature backlogs and business goals into a sequenced product roadmap. Useful for planning priorities across quarters. Claude Code CX Codex Cursor +1 3,700installs company-research deanpeters Builds a company brief from public sources: quotes from leaders, product strategy, how the org works. Useful before an interview, a partner meeting or a competitor review. Claude Code CX Codex Cursor +1 3,400installs discovery-process deanpeters Structures product discovery from an initial assumption to tested solutions so teams build features based on verified customer needs. Claude Code CX Codex Cursor +1 3,200installs jobs-to-be-done deanpeters The skill breaks customer needs into functional, social and emotional jobs, plus pains and gains. Useful when feature requests keep arriving with no reason behind them. Claude Code CX Codex Cursor +1 3,100installs pestel-analysis deanpeters Runs a product or market through the six PESTEL forces and fills a ready template. Useful before entering a new market or setting next year's roadmap. Claude Code CX Codex Cursor +1 2,400installs

Similar

file-organizer davepoon Analyzes folders, finds duplicates, suggests structure, and moves files with your approval. Uses bash commands. Claude Code CX Codex Cursor +1 346installs cass Dicklesworthstone This skill teaches an agent to query cass, a CLI that indexes local coding-agent history, so old sessions and the exact lines you need come back as JSON. Claude Code CX Codex Cursor +1 3,300installs workflow-from-chats cursor Mines recent agent conversations to turn recurring feedback and habits into skills, rules, or workflow guides. Claude Code CX Codex Cursor +1 2,100installs discover-plugins ruvnet A skill that discovers and recommends ruflo plugins based on your workflow, installed MCP tools, and current task. Handy when starting a new project or figuring out which plugins fit your needs. Claude Code CX Codex Cursor +1 757installs autopilot-loop ruvnet A skill that runs one iteration of an autonomous loop: checks progress, picks the next task, schedules the next wake. Use it when you want Claude to keep working without manual breaks between tasks. Claude Code CX Codex Cursor +1 752installs horizon-track ruvnet Tracks long-term objectives across multiple sessions, stores milestones in persistent memory, and flags project drift. Claude Code CX Codex Cursor +1 746installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs

Questions about user-story

How do I install user-story in Claude Code?

Run npx skills add deanpeters/Product-Manager-Skills --skill user-story -a claude-code or place the file directly into ~/.claude/skills/user-story/SKILL.md.

What does the user-story skill do?

It generates user stories structured as As a, I want, so that, complemented by executable Gherkin scenarios for engineering and testing teams.

Should this skill be used for technical debt?

No. Pure refactoring and architectural chores belong in developer task tickets, as this skill focuses on user personas and observable outcomes.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor