bmad-create-story

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

2|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Wizarck/nexandro --skill bmad-create-story-wizarck
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/Wizarck/nexandro/tree/main/skills/bmad-create-story
Command: npx skills add https://github.com/Wizarck/nexandro --skill bmad-create-story-wizarck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Development agents often fail because story files lack the technical context needed for correct implementation, leading to reinvented wheels, wrong libraries, and broken regressions. This Skill creates fully-contextualized 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 Gathering: Loads epics, PRD, architecture, and UX documents (whole or sharded) 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, enhancement opportunities, and LLM-optimization issues before marking the story ready-for-dev. - Use Case: A team using the BMAD method runs sprint planning, then asks the agent to create the next story; the Skill produces a story file with acceptance criteria, architecture guardrails, library versions, and testing requirements, and updates sprint status automatically. ## Quick Start Ask the agent to create the next story from the sprint backlog, or specify a story such as "create story 2-1" to generate a ready-for-dev story 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 extracts the epic and story numbers from the key, gathers all context, and writes the story file automatically.

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 from your input and skips the sprint-status auto-discovery step.

What documents does the create-story workflow need?▼

It loads epics, PRD, architecture, and UX files from your planning artifacts directory, supporting both whole files and sharded folders. Missing documents are tolerated; the workflow notes them as unavailable and continues with what exists.

Does the workflow update sprint status automatically?▼

Yes. After creating the story file, it sets the story status to ready-for-dev in sprint-status.yaml and marks the parent epic as in-progress if this is its first story. It halts with an error if the epic is already marked done.

What happens if no backlog stories are found?▼

The workflow halts and reports that all stories are already created, in progress, or done. It suggests running sprint-planning to refresh tracking, using correct-course to add stories, or running a retrospective if the sprint is complete.