user-story

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

12|3|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/phuhao00/bony-agent --skill user-story-phuhao00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/phuhao00/bony-agent/tree/main/.agent/skills/user-story
Command: npx skills add https://github.com/phuhao00/bony-agent --skill user-story-phuhao00

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill solves the common challenge of vague, unmeasurable requirements by providing a structured framework that ensures user stories are outcome-focused, testable, and clear to both product and engineering teams.

Core Features & Use Cases

  • Mike Cohn Format: Standardizes the As a, I want to, so that structure to ensure user-centric value.
  • Gherkin Acceptance Criteria: Enforces Given, When, Then logic to make stories verifiable and testable by QA.
  • Use Case: Use this when you need to translate a high-level user need into a concrete, actionable ticket for a sprint, ensuring everyone understands the success criteria before development begins.

Quick Start

Use the user-story skill to generate a story template for a user logging in with Google to improve signup conversion.

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 my product backlog?

User stories with Gherkin acceptance criteria are generated using the Mike Cohn format (As a, I want to, so that) and Given-When-Then logic. This translates user needs into actionable, testable sprint tickets for product management and engineering workflows.

What is the best way to structure agile user stories so engineering teams can test them?

The best way to structure agile user stories for testing is combining the Mike Cohn format for user-centric value with Gherkin-style acceptance criteria. Given-When-Then logic makes stories verifiable by QA and ensures clear alignment on success conditions before development begins.

How does Gherkin format work when translating user needs into development tasks?

Gherkin format works by enforcing Given-When-Then logic to define verifiable success conditions for development tasks. Paired with the As a-I want to-so that structure, it ensures user stories remain outcome-focused, testable, and clear to both product and engineering teams.

When do I need Gherkin acceptance criteria for my agile backlog items?

You need Gherkin acceptance criteria when translating high-level user needs into concrete sprint tickets. It solves the challenge of vague, unmeasurable requirements by ensuring stories are outcome-focused and verifiable by QA before development starts.

Can I use Mike Cohn user story format for complex product management workflows?

Yes, the Mike Cohn user story format standardizes the As a, I want to, so that structure for complex product management workflows. It ensures user-centric value across all backlog items, regardless of workflow complexity.

Why does my agile backlog have untestable user stories despite having acceptance criteria?

Agile backlogs often have untestable user stories because acceptance criteria lack structured Given-When-Then logic. Gherkin format enforces verifiable success conditions, ensuring stories are testable by QA and aligned with desired outcomes before development begins.