user-story

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

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/newkayak12/claude-skills --skill user-story-newkayak12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/newkayak12/claude-skills/tree/main/plugins/newkayak12-skills/skills/user-story
Command: npx skills add https://github.com/newkayak12/claude-skills --skill user-story-newkayak12

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 work by creating clear, concise user stories with Gherkin-style acceptance criteria, ensuring shared understanding and testable outcomes.

Core Features & Use Cases

  • User Story Creation: Formulates stories using the "As a / I want to / so that" format.
  • Acceptance Criteria: Defines testable conditions using Gherkin's "Given / When / Then" structure.
  • Use Case: You need to define a new feature for your product. Use this Skill to write a user story for "allowing users to reset their password" with clear steps on how to verify it works.

Quick Start

Use the user-story skill to write a user story for a new notification system in our B2B SaaS app.

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 agile development?

To write user stories for agile development, formulate stories using the Mike Cohn "As a / I want to / so that" format, then define testable acceptance criteria using Gherkin's "Given / When / Then" structure to ensure clear, actionable outcomes.

What is the best way to translate product requirements into testable Gherkin acceptance criteria?

The best way to translate product requirements into testable Gherkin acceptance criteria is to map user needs directly into "Given / When / Then" statements, ensuring every development task has clear outcomes and verifiable conditions for sprint planning.

Can I use Gherkin format for backlog grooming in B2B SaaS products?

Yes, you can use the Gherkin format for backlog grooming in B2B SaaS products by defining testable conditions for new features like a notification system, ensuring stories remain user-centric and outcome-focused.

How to structure outcome-focused user stories for sprint planning?

To structure outcome-focused user stories for sprint planning, combine the "As a / I want to / so that" format with Gherkin-style acceptance criteria, translating user needs into development-ready work with shared understanding.

Does generating user stories require prior knowledge of the Mike Cohn format?

Generating user stories using this approach applies the Mike Cohn format automatically, so you do not need deep prior expertise to formulate user-centric stories and translate product needs into development tasks.