user-story

Create user stories with As a/I want/so that and Gherkin acceptance criteria.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Product and engineering teams often receive vague requirements that lack clear user value, measurable outcomes, and testable acceptance criteria, which leads to misaligned implementation and unclear definitions of done. This Skill helps convert user needs and product requirements into concise, outcome-focused user stories that are ready for development and QA.

Core Features & Use Cases

  • Structured Story Format: Produces Mike Cohn style Use Cases (As a / I want / so that) to keep focus on user value.
  • Testable Acceptance Criteria: Generates Gherkin-style Given / When / Then acceptance criteria that QA and engineering can validate.
  • Practical Guidance: Includes quality checks, splitting guidance, and examples to help product managers refine stories during grooming and sprint planning.
  • Use Case Example: Convert a PRD requirement into a single, testable backlog item with a short summary, persona, and clear acceptance criteria.

Quick Start

Write a user story for a trial user who wants to log in with Google so that they can access the app without creating a new password and include Gherkin acceptance criteria.

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

Write user stories using Mike Cohn's 'As a / I want / so that' structure to focus on user value, then add Gherkin Given/When/Then acceptance criteria so QA and engineering can validate the outcome. This produces testable, development-ready backlog items.

How do I convert a PRD into testable Gherkin acceptance criteria?

Convert a PRD requirement into a single backlog item by generating a concise persona use case and pairing it with Gherkin Given/When/Then acceptance criteria. This translates vague product requirements into measurable, testable conditions for development.

What is the best way to split large user stories during sprint planning?

Split large user stories during sprint planning by applying included guidance on decomposition for QA and engineering. This ensures each backlog item remains outcome-focused, testable, and small enough to fit within a single sprint cycle.

How does Gherkin Given/When/Then format work for defining a definition of done?

Gherkin Given/When/Then defines the definition of done by specifying a clear context, action, and expected outcome for each user story. This format provides QA and engineering with unambiguous, testable validation steps directly from the requirements.

Do I need prior product management experience to use structured user story templates?

No prior product management experience is strictly required to use structured user story templates. The format applies to product managers and teams preparing backlog items, providing practical examples and quality checks to refine stories during grooming.

Why do vague requirements lead to misaligned implementation and how can user stories fix it?

Vague requirements lack clear user value and testable acceptance criteria, causing misaligned implementation. User stories fix this by combining outcome-focused 'As a/I want/so that' structures with Gherkin validation to ensure a clear definition of done.