gds-create-epics-and-stories

Create epics and stories with acceptance criteria from GDD requirements.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill gds-create-epics-and-stories-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-create-epics-and-stories
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/gds-create-epics-and-stories
Command: npx skills add https://github.com/watchthelight/shatterfish --skill gds-create-epics-and-stories-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a Game Design Document, architecture decisions, and UX specifications into a structured, developer-ready backlog of epics and stories is slow and error-prone. This Skill guides a collaborative, step-by-step workflow that extracts every requirement and decomposes it into actionable stories with testable acceptance criteria. ## Core Features & Use Cases - Requirements Extraction: Validates and parses GDD, Architecture, and UX Design documents to inventory all FRs, NFRs, and UX design requirements. - Epic Design: Organizes requirements into user-value-focused epics with a full FR coverage map and explicit user approval gates. - Story Generation: Produces stories in As a/I want/So that format with Given/When/Then acceptance criteria, sized for a single dev agent. - Use Case: After finishing a GDD for a new game, run this workflow to produce a complete epics.md where every requirement maps to at least one validated story ready for development. ## Quick Start Ask the assistant to create epics and stories from the GDD, architecture, and UX documents in the planning artifacts folder.

Frequently Asked Questions about gds-create-epics-and-stories

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create epics and stories from a GDD?

Run this workflow with your GDD, Architecture, and optional UX Design documents in the planning artifacts folder. It extracts all requirements, proposes an epic structure for approval, then generates stories with acceptance criteria into an epics.md file.

What documents are required for epic and story creation?

A GDD containing functional and non-functional requirements and an Architecture document are required. A UX Design document is optional but treated as a first-class input whose requirements must also be covered by stories.

How are acceptance criteria written for game development stories?

Each story uses the As a/I want/So that format with acceptance criteria in Given/When/Then structure. Criteria must be independently testable, reference specific requirements, and include edge cases and error conditions.

Can stories depend on future stories in the same epic?

No. The workflow explicitly forbids forward dependencies. Each story must be completable using only the output of previous stories, and each epic must deliver standalone value without requiring later epics.

What happens if requirements are missing from the epic breakdown?

The final validation step checks every FR against the story breakdown and fails if any requirement lacks coverage. It also validates architecture compliance, story sizing, and file-churn patterns across epics before completion.