write-user-stories

Convert product briefs into user stories with Given/When/Then acceptance criteria.

19|3|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/qa-aman/claude-skills --skill write-user-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-user-stories
Source: https://github.com/qa-aman/claude-skills/tree/main/skills/by-role/pm/write-user-stories
Command: npx skills add https://github.com/qa-aman/claude-skills --skill write-user-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert vague briefs into clear, actionable user stories with acceptance criteria, enabling rapid backlog creation and sprint planning.

Core Features & Use Cases

  • Build the narrative spine from a product journey
  • Create a walking skeleton that covers the full flow
  • Write story headlines in the format: As a [user], I want [goal], so that [benefit]
  • Define acceptance criteria using Given/When/Then for happy paths and edge cases
  • Slice stories into releases to plan incremental delivery
  • Track dependencies to surface sequencing constraints

Quick Start

Provide a product brief and the skill will generate a walking skeleton of user stories with acceptance criteria.

Frequently Asked Questions about write-user-stories

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

FAQPage Schema
How do I write agile user stories with acceptance criteria from a vague product brief?

To write agile user stories from a vague product brief, the skill converts the input into a narrative-driven walking skeleton and formats stories as "As a [user], I want [goal], so that [benefit]" with Given/When/Then acceptance criteria. This process produces backlog-ready items for sprint planning.

What is a walking skeleton in agile story mapping and release planning?

A walking skeleton in agile story mapping is a narrative spine that covers the full product flow end-to-end. It slices user stories into incremental releases and tracks dependencies to sequence delivery, ensuring that each release provides a measurable, functional slice of the product.

How do I define Given/When/Then acceptance criteria for edge cases in user stories?

To define Given/When/Then acceptance criteria for edge cases, the skill applies this structure to both happy paths and boundary conditions within user stories. This ensures that narrative-driven product briefs yield measurable, testable criteria for backlog-ready agile story mapping.

Can I use story mapping to slice user stories into releases and track dependencies?

Yes, you can use story mapping to slice user stories into releases and track dependencies. The skill processes strategy documents and feature ideas to surface sequencing constraints, guiding incremental delivery planning by mapping out the walking skeleton across sprints.

What is the best way to structure backlog-ready user stories for sprint planning?

The best way to structure backlog-ready user stories for sprint planning is to build a narrative spine from the product journey. This approach formats headlines as user goals and defines Given/When/Then acceptance criteria to ensure measurable outcomes before release slicing.