bmad-create-story

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

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-create-story-unbakedcosmos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/unbakedcosmos/thumbnailer/tree/main/.claude/skills/bmad-create-story
Command: npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-create-story-unbakedcosmos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developer agents often fail because stories lack context: wrong libraries, wrong file locations, broken regressions, and ignored UX requirements. This Skill creates a complete story file that gives the dev agent everything needed for correct implementation. ## Core Features & Use Cases - Automatic Story Discovery: Reads sprint-status.yaml to find the next backlog story, or accepts an explicit epic-story number like 2-4. - Exhaustive Context Gathering: Analyzes epics, PRD, architecture, UX docs, previous story learnings, and recent git history to build developer guardrails. - Quality Validation: Runs a checklist-based review pass that identifies critical gaps and applies fixes before marking the story ready-for-dev. - Use Case: After sprint planning, ask for the next story and receive a fully-contextualized story file with acceptance criteria, architecture compliance notes, file structure requirements, and testing standards, with sprint status updated automatically. ## Quick Start Ask the agent to create the next story from the sprint backlog, or specify a story such as "create story 1-2-user-auth".

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 generates a complete story file and updates the status to ready-for-dev.

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

Provide the epic-story identifier directly, such as "create story 2-4" or "1-2-user-auth". The workflow parses the numbers, loads the matching epic context, and generates the story file for that specific item.

What documents does the story creation workflow need?▼

It uses epics, PRD, architecture, and UX documents from your planning artifacts folder, plus sprint-status.yaml. Missing documents are handled gracefully, but richer inputs produce more complete developer guidance.

What happens if no sprint status 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 guess a story without input.

Does the workflow validate the story before finishing?▼

Yes. After generating the story file, it validates against a quality checklist that checks for missing technical requirements, regression risks, and vague implementation guidance, applying fixes before marking the story ready-for-dev.