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.