user-story
Create structured user stories using the Mike Cohn format with Gherkin acceptance criteria to translate requirements into testable, development-ready tasks.
Introduction
This skill provides a standardized framework for product managers and technical teams to craft high-quality user stories that bridge the gap between user needs and actionable engineering tasks. By combining the Mike Cohn user story format—As a [persona], I want to [action], so that [outcome]—with Gherkin-style acceptance criteria, it ensures that every feature is grounded in user value while remaining technically verifiable.
-
Employs the standard industry format: As a [persona], I want to [action], so that [outcome].
-
Integrates Gherkin syntax (Given/When/Then) for precise, testable acceptance criteria.
-
Promotes a conversational approach to product development, acting as a prompt for collaboration rather than a static technical specification.
-
Incorporates validation checks to ensure stories are outcome-focused and avoid common anti-patterns like task-based requirements or feature bloat.
-
Facilitates clarity between product, design, and engineering teams, reducing ambiguity during sprint planning and backlog grooming.
-
Use this skill when you need to translate vague customer feedback or high-level goals into concrete, actionable development tickets.
-
Perfect for sprint planning, backlog refinement, and preparing requirements for QA and development cycles.
-
Avoid using this for pure technical debt or infrastructure refactoring tasks; for those, utilize dedicated engineering task frameworks.
-
If a story grows too complex, use this alongside splitting strategies to break it into smaller, independently deliverable user stories.
-
Ensure you have a defined persona and problem statement before initiating this skill to maintain user-centricity.
-
The output is optimized for clarity, focusing on measurable outcomes and testable success conditions that help prevent scope creep and ensure shared understanding across the team.
Repository Stats
- Stars
- 3,853
- Forks
- 505
- Open Issues
- 7
- Language
- Shell
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- Apr 29, 2026, 08:09 AM