gds-create-story

Generates implementation-ready story files from epics, architecture, and sprint status for game development.

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill gds-create-story-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gds-create-story
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/gds-create-story
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill gds-create-story-jgabriellima

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often receive vague or incomplete story requirements, leading to wrong libraries, broken regressions, and missed acceptance criteria. This Skill creates a comprehensive story file that gives the dev agent every piece of context needed for correct 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 "1-2-user-auth". - Exhaustive Context Extraction: Analyzes epics, GDD, architecture, UX documents, project-context.md, previous story learnings, and git history to build developer guardrails. - Quality Validation: Validates the generated story against a checklist that hunts for missing requirements, vague instructions, and LLM-optimization issues before marking it ready-for-dev. - Use Case: A game development team finishes sprint planning and asks the agent to "create the next story"; the Skill produces a fully-contextualized story file with acceptance criteria, architecture compliance rules, and testing requirements, then updates sprint status to ready-for-dev. ## 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 a complete implementation-ready story 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 skill with a request like "create the next story" and it reads sprint-status.yaml to find the first story with backlog status. It then generates a complete story file and updates the status to ready-for-dev.

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

Provide an identifier such as "1-2-user-auth" or "epic 1 story 5" when invoking the skill. It parses the epic number, story number, and title, then generates the story file for that specific item.

What documents does the story creation workflow need?▼

It loads epics, GDD, architecture, and UX documents from the planning artifacts directory, plus project-context.md if it exists. Missing files are tolerated, but richer inputs produce more complete developer guidance.

What happens if no sprint status file exists?▼

The workflow halts and asks you to either run sprint-planning first to initialize sprint-status.yaml, provide an explicit epic-story number, or supply a path to story documents.

How does the skill prevent developer implementation mistakes?▼

It extracts architecture constraints, library versions, file structure rules, previous story learnings, and git history into the story file, then validates the result against a quality checklist before marking it ready-for-dev.