create-stories

Decomposes a game design epic into implementable story files with acceptance criteria and test specs.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill create-stories-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-stories
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/create-stories
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill create-stories-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Breaking a large game design epic into small, implementable stories is error-prone: requirements get lost, acceptance criteria become untestable, and traceability to design documents breaks down. This Skill automates that decomposition while preserving full traceability to GDD requirements, architecture decisions, and QA test cases. ## Core Features & Use Cases - Epic-to-Story Decomposition: Reads an epic, its GDD, governing ADRs, and the control manifest, then groups acceptance criteria into right-sized stories (2-4 hour sessions) classified by type (Logic, Integration, Visual/Feel, UI, Config/Data). - Traceability Embedding: Each story file embeds its TR-ID from the traceability registry, governing ADR guidance, control manifest rules, and a required test evidence path. - QA Gate Integration: Optionally spawns a qa-lead gate (QL-STORY-READY) to validate testability, and generates Given/When/Then test specs or manual verification steps per story. - Use Case: After running create-epics for a combat system, run this Skill to produce story-001 through story-NNN files under production/epics/combat/, each ready for story-readiness and dev-story implementation. ## Quick Start Run $ai-game-studio:create-stories combat to break the combat epic into implementable story files with acceptance criteria and QA test cases.

Frequently Asked Questions about create-stories

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

FAQPage Schema
How do I break a game design epic into user stories?

Run $ai-game-studio:create-stories with the epic slug or path, for example $ai-game-studio:create-stories combat. It reads the epic, GDD, ADRs, and control manifest, then proposes a story list for your approval before writing files to production/epics/[epic-slug]/.

What inputs does story decomposition from a GDD require?

It requires the epic's EPIC.md file, the linked GDD with acceptance criteria, all governing ADR files present on disk, the control manifest, and the TR registry. If any referenced ADR file is missing, the skill stops and asks you to create it first.

What happens if a governing ADR is still in Proposed status?

Stories governed by a Proposed ADR are written with Status: Blocked and a note to run the architecture-decision skill to advance the ADR. Only Accepted ADRs allow a story to be marked Ready.

Does create-stories generate test cases for each story?

Yes. For Logic and Integration stories it produces Given/When/Then test specs per acceptance criterion; for Visual/Feel and UI stories it produces manual verification steps. These are embedded in each story's QA Test Cases section.

When should I not use automated epic-to-story decomposition?

Avoid it when the epic lacks a GDD with concrete acceptance criteria or when governing ADRs do not exist yet, since the skill refuses to invent requirements. Create the GDD and ADRs first, then decompose.