user-story

Translate user needs into Mike Cohn user stories with Gherkin acceptance criteria.

358|11|Updated May 15, 2026
One-click install
npx skills add https://github.com/getcrew44/crew44 --skill user-story-getcrew44
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/getcrew44/crew44/tree/main/daemon/internal/presets/defaultcrew/skills/product/user-story
Command: npx skills add https://github.com/getcrew44/crew44 --skill user-story-getcrew44

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you translate user needs into development-ready user stories that clearly communicate value and come with acceptance criteria that teams can verify.

Core Features & Use Cases

  • Mike Cohn user story structure: Captures who, what they want, and why it matters in the standard “As a / I want to / so that” format.
  • Gherkin-style acceptance criteria: Produces “Given / When / Then” scenarios that make outcomes testable and unambiguous.
  • Conversation starter quality: Ensures the output supports shared understanding across product, engineering, and QA rather than pretending to be a final feature spec.

Example use case: convert a PRD requirement into a user story for a “notification system” so engineering knows the exact user outcome and QA can write tests from the Given/When/Then.

Quick Start

Ask the AI to convert your requirement into a Mike Cohn user story with Gherkin Given/When/Then acceptance criteria that are specific and testable.

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 acceptance criteria for backlog grooming?

To write user stories for backlog grooming, translate user needs into the Mike Cohn “As a / I want to / so that” format, paired with Gherkin Given/When/Then acceptance criteria to ensure outcomes are testable and unambiguous for engineering and QA teams.

What is the best way to convert PRD requirements into Gherkin acceptance criteria?

The best way to convert PRD requirements into Gherkin acceptance criteria is to map each product requirement to a Given/When/Then scenario, enforcing a single When and Then per story to maintain clear, testable boundaries and avoid feature list bloat.

How does the Given/When/Then format make user stories testable?

The Given/When/Then format makes user stories testable by defining explicit preconditions, single actions, and expected outcomes, providing QA teams with unambiguous scenarios that can be directly translated into automated test cases.

Can I use Gherkin scenarios for sprint planning instead of feature lists?

Yes, you can use Gherkin scenarios for sprint planning instead of feature lists. By capturing who, what, and why in standard user stories with strict Given/When/Then boundaries, teams achieve shared understanding rather than working from rigid feature specs.

Why should user stories avoid task lists and feature specs?

User stories should avoid task lists and feature specs because they are designed as conversation starters that support shared understanding across product and engineering teams, rather than pretending to be final, rigid feature specifications.

Do I need Mike Cohn format for product requirements definition?

Using the Mike Cohn format for product requirements definition captures the who, what, and why in an “As a / I want to / so that” structure, ensuring development-ready user stories that clearly communicate value and come with verifiable acceptance criteria.