user-story-breakdown

Breaks down epics into user stories with acceptance criteria, story points, and sprint plans.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/codewizwit/human-in-the-loop --skill user-story-breakdown-codewizwit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: user-story-breakdown
Source: https://github.com/codewizwit/human-in-the-loop/tree/main/lib/skills/user-story-breakdown
Command: npx skills add https://github.com/codewizwit/human-in-the-loop --skill user-story-breakdown-codewizwit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a large epic or feature request into sprint-ready work items is time-consuming and error-prone. This Skill structures that process by generating INVEST-compliant user stories with acceptance criteria, estimates, dependencies, and sprint allocation in a single markdown deliverable. ## Core Features & Use Cases - Epic Decomposition: Splits epics into user stories following INVEST criteria, each with Given/When/Then acceptance criteria, story points, technical notes, and dependencies. - Sprint Planning Output: Produces a story map table, sprint recommendations, risk assessment, and total estimates written to a markdown file. - Interactive Scoping: Asks for epic description, user personas, technical context, and preferred estimation method (Fibonacci, T-Shirt, linear, or none) before generating output. - Use Case: Given an authentication epic covering signup, login, password reset, OAuth, and RBAC on a React/Node/PostgreSQL stack, generate a full story breakdown with sprint allocation and risk table. ## Quick Start Ask the assistant to break down your epic into user stories, for example: "Break down our user authentication epic into sprint-ready stories with acceptance criteria and Fibonacci estimates."

Frequently Asked Questions about user-story-breakdown

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

FAQPage Schema
How do I break down an epic into user stories?▼

Describe the epic, target personas, and technical context, then choose an estimation method. The Skill generates INVEST-compliant stories with acceptance criteria, story points, dependencies, and a sprint plan written to a markdown file.

What estimation methods does story breakdown support?▼

It supports Fibonacci (1, 2, 3, 5, 8, 13), T-Shirt sizes (XS through XL), linear 1-10 scales, or no estimation. You select the method during the interactive setup questions.

What is the INVEST criteria for user stories?▼

INVEST stands for Independent, Negotiable, Valuable, Estimable, Small, and Testable. The Skill applies these criteria to every generated story to ensure each one fits in a sprint and has clear success criteria.

Can I skip providing user personas and technical context?▼

Yes, both inputs are optional. The Skill infers personas from the epic description and derives technical context by reading the codebase when you skip those questions.

What output format does the story breakdown produce?▼

It writes a markdown file containing an epic summary, story map table, detailed stories with acceptance criteria and testing strategies, sprint recommendations, a risk assessment table, and total point estimates.