write-user-story

Generate user stories with Gherkin acceptance criteria from feature descriptions.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/hpsgd/claude-marketplace --skill write-user-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-user-story
Source: https://github.com/hpsgd/claude-marketplace/tree/main/plugins/product/product-owner/skills/write-user-story
Command: npx skills add https://github.com/hpsgd/claude-marketplace --skill write-user-story

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting product descriptions, PRDs, or feature notes into well-structured, hand-off ready user stories is time-consuming and error-prone when done manually. This Skill automates the craft by guiding you through clear user types, discrete behaviours, acceptance criteria, edge cases, anti-requirements, and proper sizing.

Core Features & Use Cases

  • Generate one well-scoped user story per behaviour from a feature description, PRD section, or initiative summary.
  • Produce Gherkin-like acceptance criteria for each story, including success and negative paths.
  • Enforce ISC-validated structure: explicit user types, single-action stories, and explicit exclusions via anti-requirements.
  • Provide a ready-to-hand-off artifact that engineers can start from without additional conversation or clarification.
  • Supports outputs suitable for product-management and development handoffs across cross-functional teams.

Quick Start

Provide a feature description or PRD excerpt and I will generate complete user stories with acceptance criteria.

Frequently Asked Questions about write-user-story

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn feature notes into structured user stories with acceptance criteria?

To turn feature notes into user stories, provide a feature description or PRD excerpt. The system outputs ISC-validated stories with distinct user types, single-action behaviors, and Gherkin acceptance criteria for immediate engineering handoff.

What is the best way to write user stories that cover edge cases and anti-requirements?

Writing user stories with edge cases and anti-requirements requires enforcing ISC-validated formatting. This approach generates one-behavior-per-story, explicitly defines exclusions via anti-requirements, and validates story size to prevent scope creep.

How does Gherkin formatting work for product management acceptance criteria?

Gherkin acceptance criteria define explicit success and negative paths for each behavior. Applying this to product management ensures cross-functional teams receive handoff-ready artifacts with clear user types and discrete single-action stories without needing further clarification.

Can I generate user stories directly from a PRD section for cross-functional teams?

Yes, you can generate user stories directly from a PRD section. Processing a feature summary produces comprehensive stories complete with Gherkin-like acceptance criteria, edge cases, and anti-requirements suitable for development handoffs across cross-functional teams.

Do I need to manually size user stories when converting a feature description?

No, manual sizing is unnecessary when converting feature descriptions. The process enforces size validation inherently, ensuring each generated user story represents a single behavior and remains properly scoped for engineers to start work immediately.