user-story

Installation
Summary

Translate user needs into development-ready stories with Mike Cohn format and Gherkin acceptance criteria.

  • Combines "As a / I want / so that" user story structure with "Given / When / Then" acceptance criteria for testable, outcome-focused work
  • Includes quality checks and anti-patterns to avoid generic personas, vague outcomes, and scope creep
  • Designed for backlog grooming, sprint planning, and shared understanding between product, engineering, and QA
  • Emphasizes stories as conversation starters, not locked contracts; includes guidance on when to split oversized stories
SKILL.md

Purpose

Create clear, concise user stories that combine Mike Cohn's user story format with Gherkin-style acceptance criteria. Use this to translate user needs into actionable development work that focuses on outcomes, ensures shared understanding between product and engineering, and provides testable success criteria.

This is not a feature spec—it's a conversation starter that captures who benefits, what they're trying to do, why it matters, and how you'll know it works.

Key Concepts

The Mike Cohn + Gherkin Format

A user story combines:

Use Case (Mike Cohn format):

  • As a [user persona/role]
  • I want to [action to achieve outcome]
  • so that [desired outcome]

Acceptance Criteria (Gherkin format):

  • Scenario: [Brief description of the scenario]
  • Given: [Initial context or preconditions]
Related skills
Installs
1.7K
GitHub Stars
4.2K
First Seen
Feb 12, 2026