user-story

The 'user-story' skill helps product managers, designers, and engineers create structured user stories using Mike Cohn's format with Gherkin-style acceptance criteria. It focuses on translating user needs into actionable development work with clear outcomes and testable conditions, promoting shared understanding across teams. This skill ensures stories capture who benefits, what they want to achieve, and why it matters, while providing concrete scenarios to validate success.

Main capabilities include generating well-formed user stories with defined user personas, desired outcomes, and constraints. It provides a consistent format combining Mike Cohn's 'As a/I want/So that' template with Gherkin 'Given/When/Then' acceptance criteria. The skill supports backlog grooming, sprint planning, and communication of value to engineering and QA teams. Optional helper scripts allow deterministic Markdown template generation for consistent story documentation.

Typical use cases involve converting product requirements or PRDs into actionable user stories, writing stories for new features or systems in software projects, and establishing quality standards for user story creation. Target users include product managers, UX designers, developers, and QA engineers who need testable and outcome-focused stories to guide development work.