bmad-create-story

Generate a ready-for-dev story file from epic and story inputs.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-create-story-amitmishra-byldd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/amitmishra-byldd/Bmad-Note-Maker/tree/main/_bmad/bmm/4-implementation/bmad-create-story
Command: npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-create-story-amitmishra-byldd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a dedicated story file that consolidates all context a dev-agent needs to implement a story, eliminating manual assembly and ensuring consistency with project standards.

Core Features & Use Cases

  • Automatically generates a complete story file from epic/story inputs, templates, and workflow references.
  • Aligns with planning artifacts (epics, prd, architecture) to provide cross-cut context and guardrails.
  • Produces a ready-for-dev document that can be loaded by the dev-agent and validated against the checklist.

Quick Start

Provide the epic number and story number (or the full story key) and I will generate a ready-for-dev story file with all required sections.

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 a ready-for-dev story file from planning artifacts?

To generate a ready-for-dev story file, provide the epic number and story number. The process analyzes your planning artifacts, project context, and templates to consolidate all required context into a single document for the dev-agent.

What is a ready-for-dev story file in software engineering workflows?

A ready-for-dev story file is a consolidated document containing all cross-cut context, guardrails, and planning references a dev-agent needs to implement a specific story, ensuring consistency with project standards and eliminating manual assembly.

How do I create story files that align with my existing epics and architecture documents?

You can create aligned story files by providing the epic and story identifiers. The generation process automatically analyzes your existing epics, prd, and architecture planning artifacts to ensure the output adheres to your template structure.

Does this story creation process integrate with sprint status and workflow documentation?

Yes, the generated story file integrates directly with the sprint status and workflow described in your workflow.md. It produces a document designed to be loaded by the dev-agent and validated against the project checklist.

What inputs do I need to provide to automate dev story file creation?

You need to provide the epic number and story number, or the full story key. The process then uses these inputs alongside your project's planning artifacts, templates, and context engine to generate the complete story file.

Can I use this to add guardrails to my ai-agent software engineering tasks?

Yes, the generated story file includes guardrails by aligning with your planning artifacts and architecture. This ensures the dev-agent receives cross-cut context and project standards directly within the ready-for-dev document.