bmad-create-story

Generate structured dev-story Markdown files with guardrails and references.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-create-story-imaginerlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/ImaginerLabs/skill-manager/tree/main/.trae/skills/bmad-create-story
Command: npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-create-story-imaginerlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines the creation of complete, ready-to-use dev-story files that previously required manual assembly and scattered references.

Core Features & Use Cases

  • Automatic story synthesis: Generate a structured story file from epic/story inputs, embedding guardrails, acceptance criteria, and source hints.
  • Workflow integration: Aligns with sprint planning and templates to ensure consistency and traceability across stories.
  • Ready-for-dev output: Produces a Markdown file with status, references, and dependencies suitable for immediate implementation.

Quick Start

Provide the epic and story identifiers (e.g., 1-2-user-auth) or a story template path, and the tool will generate a ready-to-use 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 automate dev-story generation for sprint planning?

To automate dev-story generation, you provide epic and story identifiers to synthesize a structured Markdown file. This file embeds context, guardrails, and implementation guidance, creating a ready-for-dev document with status and references.

What is a ready-for-dev story file and what should it include?

A ready-for-dev story file is a formalized Markdown document that guides developers through implementation. It includes structured templates, previous story intelligence, architecture constraints, acceptance criteria, status, and source hints for traceability.

Can I use existing story templates to generate new dev-stories?

Yes, you can use existing story templates by providing a story template path. The system applies the structured format, embedding guardrails and previous story intelligence to produce a consistent, ready-for-dev Markdown file.

Does dev-story generation work with epic and story workflows?

Yes, dev-story generation explicitly applies to epic and story workflows. It streamlines story file creation by aligning with sprint planning templates, ensuring consistency and traceability across stories within the epic.

How do I enforce architecture constraints and guardrails in story documentation?

You enforce architecture constraints and guardrails by using a story generation process that automatically embeds them into the structured template. This ensures the output Markdown file contains the necessary implementation guidance and acceptance criteria.

What is the best way to create consistent story files for developers?

The best way to create consistent story files is to use an automated story synthesis tool. It applies a structured template, includes previous story intelligence, and outputs a ready-for-dev Markdown file with status and dependencies for immediate implementation.