Productivity
user-story avatar

user-story

Create structured user stories using Mike Cohn's format combined with Gherkin acceptance criteria to translate user needs into testable, development-ready work.

Introduction

This skill provides a rigorous framework for product managers to transform abstract user needs into actionable development tasks. By bridging the gap between product discovery and engineering execution, it ensures that every piece of work is rooted in user value, maintains technical clarity, and remains verifiable through automated or manual testing.

  • Employs the classic Mike Cohn User Story format: As a [persona], I want to [action], so that [outcome].

  • Integrates Gherkin-style syntax for acceptance criteria (Scenario, Given, When, Then) to ensure testability and shared understanding.

  • Focuses on outcome-based development rather than mere task tracking or feature lists.

  • Provides built-in quality checks to prevent common anti-patterns like vague goals or excessively large user stories.

  • Facilitates better collaboration between product, design, and engineering teams by establishing a common language for requirements.

  • Recommended for backlog grooming, sprint planning, and documenting new feature requests.

  • Works best when combined with preceding problem statements or proto-persona definitions for full context.

  • Encourages splitting overly complex stories to maintain focus and velocity.

  • Inputs typically include user persona, identified pain points, and desired outcomes.

  • Outputs consist of a structured Markdown artifact ready for project management tools like Jira, GitHub Issues, or Linear.

  • Not intended for low-level technical debt tasks or purely architectural refactoring, which should be managed as engineering tasks.

Repository Stats

Stars
3,844
Forks
505
Open Issues
7
Language
Shell
Default Branch
main
Sync Status
Idle
Last Synced
Apr 29, 2026, 01:40 AM
View on GitHub
user-story | Skills Hub