Slash Command260 repo starsupdated 16d ago

user-story

The user-story command guides structured creation of product backlog items by walking through persona definition, standard user story formatting, acceptance criteria using Given-When-Then scenarios, and INVEST principle validation. Use this command when preparing stories for sprint planning or refining backlog items to ensure they are independent, valuable, estimable, small, and testable with clear acceptance criteria and defined scope boundaries.

View source Repository: Claude-Skills

Install in Claude Code

Copy

mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/borghei/Claude-Skills/HEAD/.claude/commands/user-story.md -o ~/.claude/commands/user-story.md

Then start a new Claude Code session; the slash command loads automatically.

Definition

user-story.md

Guide user story creation:

1. **Identify the persona** — who is this story for? Define: role, goal, context.
2. **Write the story** in standard format:
   ```
   As a [persona/role],
   I want [action/capability],
   So that [benefit/outcome].
   ```
3. **Add acceptance criteria** using Given-When-Then:
   ```
   Given [precondition],
   When [action],
   Then [expected result].
   ```
   Include 3-5 criteria covering: happy path, edge cases, and error states.
4. **INVEST check** — verify the story is:
   - **I**ndependent: can be developed without other stories
   - **N**egotiable: details can be discussed
   - **V**aluable: delivers user value
   - **E**stimable: team can size it
   - **S**mall: fits in one sprint
   - **T**estable: clear pass/fail criteria
5. **Estimate** — suggest story point range based on complexity.
6. **Edge cases** — list 2-3 scenarios the implementation must handle.
7. **Out of scope** — explicitly state what this story does NOT cover.
8. **Output** the complete user story ready for the backlog.