gds-create-story

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill gds-create-story-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-create-story
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/gds-create-story
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill gds-create-story-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing implementation stories by hand often leaves developers without the architecture constraints, previous-story learnings, and technical specifics they need, causing wrong libraries, regressions, and rework. This Skill automates the creation of a complete, context-rich story file so the dev agent has everything required for implementation. ## Core Features & Use Cases - Automatic Story Discovery: Reads sprint-status.yaml to find the next backlog story, or accepts an explicit epic-story identifier like "2-4". - Exhaustive Context Analysis: Loads epics, GDD, architecture, UX documents, project-context.md, previous story files, and git history to extract requirements and guardrails. - Structured Story Generation: Produces a story file from a template with acceptance criteria, dev notes, architecture compliance rules, and testing requirements, then updates sprint status to ready-for-dev. - Quality Validation: Runs a checklist-based review to catch missing requirements, vague instructions, and disaster risks before finalizing. - Use Case: A game development team finishes sprint planning and asks the agent to "create the next story"; the Skill analyzes all planning artifacts and outputs a ready-for-dev story file the dev agent can implement directly. ## Quick Start Ask the agent to create the next story from the sprint backlog, or specify a story such as "create story 2-4" to generate its implementation file.

Frequently Asked Questions about gds-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 then analyzes epics, architecture, and prior stories to generate a complete story file marked ready-for-dev.

How do I create a specific story by epic and story number?

Provide the story identifier directly, such as "create story 2-4" or a key like "1-2-user-auth". The workflow parses the epic number, story number, and title from your input instead of auto-discovering from the sprint status file.

What documents does the create-story workflow need?

It loads epics, architecture, GDD, and UX files from the planning artifacts directory, plus project-context.md if it exists. Missing files are tolerated, but sprint-status.yaml or an explicit story identifier is required to select a target story.

What happens if no backlog stories are found in sprint status?

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.

How does the story file prevent developer implementation mistakes?

The generated story embeds architecture compliance rules, library and version requirements, file structure constraints, previous story learnings, and project context rules. A checklist validation step then reviews the file for gaps, vague instructions, and regression risks before finalizing.