user-story

Create user stories in Mike Cohn format with Gherkin acceptance criteria and story maps.

Updated Jul 21, 2026
One-click install
npx skills add https://github.com/BrunoL28/product-onboarding-skill --skill user-story-brunol28
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/BrunoL28/product-onboarding-skill/tree/main/skills/user-story
Command: npx skills add https://github.com/BrunoL28/product-onboarding-skill --skill user-story-brunol28

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often write vague backlog items that name UI widgets instead of user outcomes, lack testable acceptance criteria, or hide multiple stories inside one. This Skill turns user needs into development-ready stories with a stable output schema that imports cleanly into Jira and Azure DevOps. ## Core Features & Use Cases - Mike Cohn story format: Produces As a / I want to / so that stories with three line tests that catch generic personas, widget-naming, and restated motivations. - Gherkin acceptance criteria: Generates Given/When/Then scenarios covering happy path, error path, and at least one negative case, enforcing the one-When-one-Then split-signal rule. - Story mapping with release slices: Builds a backbone of activities, steps, and stories, then cuts horizontal release slices starting with a walking skeleton. - Use Case: Given a problem statement or spec for a banking dispute feature, generate US-1 through US-7 with acceptance criteria, detect a two-When story and split it, then assemble a story map whose first slice spans the whole user journey. ## Quick Start Ask the assistant to write user stories with Gherkin acceptance criteria from your problem statement or spec, optionally requesting a full story map with release slices.

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?▼

Provide a persona, the problem, and the desired outcome, and the Skill produces an As a / I want to / so that story plus Given/When/Then scenarios. It covers the happy path, error path, and at least one negative case per story.

What is the one When one Then rule in user stories?▼

Each story allows exactly one When trigger and one Then outcome, while Givens may stack freely. A second When or Then signals two stories, and the Skill emits a split-signal report and hands off to epic-breakdown-advisor instead of widening the story.

How do I build a user story map with release slices?▼

Request map mode to get a backbone of user activities ordered left to right, 3-5 steps per activity, stories under each step, and horizontal release slices. The first slice is a walking skeleton spanning the whole journey thinly.

Can user stories be imported into Jira or Azure DevOps?▼

Yes, the output templates in template.md use stable field names designed as a contract for Jira and Azure DevOps import. Story IDs follow a configurable scheme such as US-<n> to match team tracker conventions.

When should a user story be split into an epic breakdown?▼

Split when a story needs a second When or Then, would take more than a few days, or spans multiple screens. The Skill detects these signals explicitly and hands off to epic-breakdown-advisor rather than quietly widening scope.