bmad-create-story

Creates structured story files with context, acceptance criteria, and task breakdowns for developer agents.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-create-story-5onyy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/5onyy/essential-ai-agent-skills/tree/main/.cursor/skills/bmad-create-story
Command: npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-create-story-5onyy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing implementation-ready user stories by hand often produces vague, incomplete tickets that cause developers to reinvent solutions, use wrong libraries, or miss critical requirements. This Skill generates a dedicated story file containing all the context a dev agent needs to implement the work correctly. ## Core Features & Use Cases - Story File Generation: Populates a structured template with summary, narrative description, testable acceptance criteria, solution approach, and impact analysis. - Complexity-Driven Structure: Adjusts story content based on story point estimates, adding sequenced TASK tables with dependencies for SP 8+ and split warnings for SP 21. - Quality Validation Checklist: Includes a review workflow that re-analyzes epics, architecture docs, and previous stories to catch missing requirements, wrong library choices, and regression risks before development starts. - Use Case: After analyzing a Jira ticket, ask the agent to create the next story; it produces a ready-for-dev story file with AC, technical guidance, and task breakdown saved to your project structure. ## Quick Start Ask the agent to create the next story for your current epic using the bmad-create-story workflow.

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 an implementation-ready user story from a Jira ticket?▼

Run the create-story workflow with the ticket key or story description. It populates a template with summary, narrative description, numbered acceptance criteria, solution approach, and impact analysis, then saves the story file to your project path.

How does story point estimation affect the generated story file?▼

Stories estimated at SP 1-5 omit the Tasks section entirely. SP 8-13 stories include a TASK table with dependency tracking, and SP 21 stories get a warning that they should be split before development begins.

Can the story creation workflow use context from a previous Jira analysis?▼

Yes. When called from the jira-analyze workflow, fields like ticket summary, acceptance criteria, story points, sub-tasks, and technical constraints are pre-filled automatically. Standalone use requires you to provide the ticket key or description.

What does the story validation checklist check for?▼

The checklist re-analyzes epics, architecture documents, previous stories, and git history to find missing technical requirements, wrong library choices, file location violations, regression risks, and vague implementation guidance before development starts.

When should I not use a generated story file for development?▼

Avoid proceeding when the story carries unresolved open questions or when it is flagged SP 21, since the workflow itself warns such stories should be split first. Also validate stories lacking defined acceptance criteria before implementation.