bmad-create-story

Generates comprehensive developer-ready story files from epics, architecture, and sprint status.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-create-story-mathematicguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/.agent/skills/bmad-create-story
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-create-story-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Development agents often fail because story files lack the context needed for correct implementation, leading to reinvented wheels, wrong libraries, broken regressions, and vague implementations. This Skill creates exhaustive story files that give the dev agent everything required for accurate implementation. ## Core Features & Use Cases - Automated Story Discovery: Reads sprint-status.yaml to find the next backlog story, or accepts an explicit epic-story identifier like "1-2-user-auth". - Exhaustive Context Extraction: Analyzes epics, PRD, architecture, and UX documents plus previous story learnings and git history to build complete developer guidance. - Quality Validation Checklist: Validates the generated story against a competitive review checklist that catches critical omissions before handoff to the dev agent. - Use Case: A team using the BMad method asks the agent to "create the next story"; the Skill locates the next backlog story, mines all planning artifacts, and writes a ready-for-dev story file with architecture compliance rules, testing requirements, and file structure constraints. ## Quick Start Ask the agent to create the next story from the sprint backlog, or specify a story such as "create story 2-4" to generate a fully contextualized implementation file.

Frequently Asked Questions about bmad-create-story

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

FAQPage Schema
How do I create the next story from my sprint backlog?▼

Run the create-story workflow with no arguments and it reads sprint-status.yaml to find the first story with backlog status. It then analyzes epics, architecture, and prior stories to generate a complete story file marked ready-for-dev.

How do I create a specific story by epic and story number?▼

Provide an identifier like "1-2-user-auth" or "epic 1 story 5" when invoking the workflow. The Skill parses the epic number, story number, and title, then generates the story file at the implementation artifacts path.

What documents does the create-story workflow need?▼

It selectively loads epics, PRD, architecture, and UX documents from the planning artifacts directory, supporting both whole files and sharded folders. Missing documents are tolerated but reduce the quality of the generated developer context.

What happens if no sprint-status.yaml file exists?▼

The workflow halts and asks you to either run sprint-planning first to initialize tracking, provide an explicit epic-story number, or supply a path to story documents. It will not proceed without a way to identify the target story.

How does the workflow prevent developer implementation mistakes?▼

It extracts architecture constraints, library versions, file structure rules, and previous story learnings into the story file, then validates the result against a quality checklist that flags missing requirements, regression risks, and vague acceptance criteria.