bmad-create-story

Generate implementation-ready markdown story files from BMAD epic and architecture artifacts.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/mol4/BMAD-Board --skill bmad-create-story-mol4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/mol4/BMAD-Board/tree/main/BMAD%20board/.agents/skills/bmad-create-story
Command: npx skills add https://github.com/mol4/BMAD-Board --skill bmad-create-story-mol4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns BMAD planning artifacts into a complete, implementation-ready story file so developers do not have to guess requirements, recreate context, or miss important constraints.

Core Features & Use Cases

  • Backlog Story Selection: Finds the next or specified story and prepares it for development.
  • Deep Context Extraction: Pulls requirements from epics, PRDs, architecture, UX notes, and prior story learnings.
  • Guardrail-First Output: Produces a structured story with technical notes, testing guidance, file targets, and sprint status updates.
  • Use Case: A PM or agent wants the next backlog item converted into a polished story that a dev agent can implement with minimal ambiguity.

Quick Start

Use the bmad-create-story skill to generate the next ready-for-dev story from the project’s BMAD artifacts.

Frequently Asked Questions about bmad-create-story

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

FAQPage Schema
How do I generate implementation-ready stories from agile epics and sprint planning artifacts?

Creating implementation-ready stories from agile epics requires extracting full context from BMAD architecture and sprint artifacts. This Skill analyzes prior story learnings and PRDs to output a complete markdown file with technical guardrails, file targets, and testing guidance for development.

What is included in a ready-for-dev story file for backlog-driven development?

A ready-for-dev story file includes deep context extracted from epics, PRDs, architecture notes, and prior story learnings. It provides structured technical notes, testing guidance, file targets, and sprint status updates to ensure developers have exhaustive context without ambiguity.

How do I add technical guardrails and implementation notes to agile story creation?

Adding technical guardrails to agile story creation involves analyzing source documents and architecture artifacts. This Skill automatically applies technical constraints, testing guidance, and implementation notes directly into the generated story markdown, ensuring all development guardrails are documented.

Can I use BMAD artifacts to select the next backlog story for sprint planning?

Yes, you can use BMAD artifacts to select the next backlog story for sprint planning. This Skill finds the next or specified story from your project artifacts and prepares it for development by pulling requirements from epics and updating sprint status.

Does this story creation process require existing PRDs and architecture documents?

Yes, story creation requires existing BMAD planning artifacts like PRDs, architecture notes, and epics. The Skill performs full analysis of these source documents to extract deep context, meaning it needs comprehensive upstream planning artifacts to generate a complete story.

Why are my agile stories missing technical context and prior story learnings?

Agile stories miss technical context when prior story learnings and architecture documents are not fully analyzed. This Skill solves that by extracting requirements from epics, UX notes, and previous learnings to produce exhaustive context with citations for the selected story.