user-story

Generate user stories with Mike Cohn format and Gherkin acceptance criteria.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/wilsto/claude-code-starter-kit --skill user-story-wilsto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/wilsto/claude-code-starter-kit/tree/main/.claude/skills/user-story
Command: npx skills add https://github.com/wilsto/claude-code-starter-kit --skill user-story-wilsto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill transforms vague user needs into clear, actionable user stories with testable acceptance criteria, ensuring everyone on the team understands the 'who', 'what', and 'why' of development tasks.

Core Features & Use Cases

  • Mike Cohn Format: Structures stories as "As a [persona], I want to [action], so that [benefit]".
  • Gherkin Acceptance Criteria: Defines success with "Given/When/Then" scenarios.
  • Use Case: A product manager can use this to quickly generate a well-defined user story for a new feature, complete with acceptance criteria that the engineering team can use for development and testing.

Quick Start

Write a user story for a new user registration flow, including acceptance criteria.

Frequently Asked Questions about user-story

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write user stories with Gherkin acceptance criteria?

To write user stories with Gherkin acceptance criteria, structure the narrative using the Mike Cohn format and define success scenarios using Given/When/Then syntax to ensure development tasks are actionable and testable.

What is the Mike Cohn format for agile user stories?

The Mike Cohn format for agile user stories structures requirements as "As a [persona], I want to [action], so that [benefit]" to clearly communicate the who, what, and why of a product feature.

How do I translate vague user needs into testable requirements?

Translate vague user needs into testable requirements by structuring them as user stories with clear personas and mapping the expected outcomes to Gherkin-style Given/When/Then acceptance scenarios.

Can I use Gherkin scenarios for backlog grooming and sprint planning?

Yes, you can use Gherkin scenarios for backlog grooming and sprint planning because they provide clear, testable acceptance criteria that ensure the entire team understands user value and success metrics.

What is the best way to format acceptance criteria for product management?

The best way to format acceptance criteria for product management is using Gherkin syntax, which structures conditions as Given/When/Then scenarios to clearly define feature success without ambiguity.

Do I need specific technical knowledge to generate agile user stories?

You do not need specific technical knowledge to generate agile user stories, as the process relies on defining personas, actions, and benefits alongside structured Given/When/Then acceptance scenarios.