user-story

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

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/Johnnnmai/100x-product-manager --skill user-story-johnnnmai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/Johnnnmai/100x-product-manager/tree/main/skills/user-story
Command: npx skills add https://github.com/Johnnnmai/100x-product-manager --skill user-story-johnnnmai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you translate user needs into actionable development tasks by creating well-defined user stories with testable acceptance criteria, ensuring clarity and alignment between product and engineering.

Core Features & Use Cases

  • User Story Creation: Generates stories using the Mike Cohn format ("As a... I want to... so that...").
  • Gherkin Acceptance Criteria: Adds precise, testable scenarios using the Given/When/Then structure.
  • Use Case: You need to define a new feature for your app. Use this Skill to write a user story for "allowing users to reset their password via email," complete with scenarios like "Given I am on the forgot password page, When I enter my email and submit, Then I receive a password reset link."

Quick Start

Write a user story for a trial user who wants to log in with Google so they can access the app without a new password.

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, generate stories using the Mike Cohn format ("As a... I want to... so that...") and define testable Given/When/Then scenarios. This translates user needs into actionable development tasks with clear success conditions.

What is the best way to convert product requirements into development-ready user stories?

Converting product requirements into development-ready user stories involves translating user needs into the Mike Cohn format and adding Gherkin-style acceptance criteria. This ensures shared understanding between product and engineering teams through testable scenarios.

How does the Given/When/Then structure work for agile acceptance criteria?

The Given/When/Then structure for agile acceptance criteria works by defining precise, testable scenarios in Gherkin syntax. Given sets the initial context, When describes the action, and Then specifies the expected outcome to ensure shared understanding.

Can I use Gherkin scenarios for agile product management features?

Yes, you can use Gherkin scenarios for agile product management features to establish testable success criteria. By applying the Given/When/Then format, you ensure shared understanding and translate user needs into actionable development work effectively.

What are the limitations of using the Mike Cohn format for user stories?

The Mike Cohn format structures user stories effectively but requires precise Gherkin acceptance criteria to avoid ambiguity. Without detailed Given/When/Then scenarios, translating complex user needs into actionable development work may lack testable success criteria for engineering teams.

Do I need prior agile experience to generate user stories with Gherkin?

You do not need extensive agile experience to generate user stories with Gherkin. This Skill facilitates the translation of user needs by automatically applying the Mike Cohn format and structuring testable Given/When/Then scenarios for development-ready output.