user-story

Write Mike Cohn user stories with Gherkin Given/When/Then acceptance criteria.

Updated Aug 18, 2024
One-click install
npx skills add https://github.com/ch-m-n/dotfile --skill user-story-ch-m-n
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/ch-m-n/dotfile/tree/main/opencode/skills/user-story
Command: npx skills add https://github.com/ch-m-n/dotfile --skill user-story-ch-m-n

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Helps product teams avoid vague, untestable backlog entries by codifying the Mike Cohn user story structure with Gherkin acceptance criteria, so every story clarifies who benefits, what changes, and how success is validated.

Core Features & Use Cases

  • Mike Cohn + Gherkin Guidance: Teaches the structure for "As a / I want / so that" plus Given/When/Then steps to keep stories user-centric and testable.
  • Context Checklists: Encourages capturing persona, problem understanding, desired outcome, and constraints before writing or committing stories.
  • Template & Examples: Supplies a Markdown template, CLI helper script, and sample stories to speed up consistent writing during backlog grooming and sprint planning.

Quick Start

Ask the Skill to write a Mike Cohn user story with Gherkin acceptance criteria for the new notification workflow.

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

To write user stories with Gherkin acceptance criteria, use the Mike Cohn format (As a / I want / so that) combined with Given/When/Then scenarios to clarify who benefits, what changes, and how success is validated during backlog grooming.

What is the best way to translate user needs into testable acceptance criteria?

The best way to translate user needs into testable acceptance criteria is structuring them as Gherkin scenarios with Given/When/Then steps, ensuring every story focuses on value, measurable triggers, and verifiable results for the target persona.

How does persona-driven user story structure work for B2B SaaS products?

Persona-driven user story structure works for B2B SaaS by capturing the specific persona, problem understanding, desired outcome, and constraints before writing the story, ensuring the resulting backlog entry directly addresses that user's context.

Can I use Given/When/Then scenarios to define outcomes during sprint planning?

Yes, you can use Given/When/Then scenarios during sprint planning to define outcomes. This Gherkin acceptance criteria structure ensures stories remain user-centric, testable, and focused on verifiable results before development begins.

Why do vague backlog entries fail and how does story structure fix them?

Vague backlog entries fail because they lack clear validation paths. Codifying the Mike Cohn user story structure with Gherkin acceptance criteria fixes this by explicitly defining who benefits, what changes, and how success is verified.

Do I need prior product management experience to use Gherkin acceptance criteria?

You do not need extensive product management experience to use Gherkin acceptance criteria, as utilizing context checklists and structured templates guides you through capturing personas, desired outcomes, and constraints to write verifiable stories.