design-system

Guides section-by-section GDD authoring for a single game system with dependency cross-referencing.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill design-system-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/design-system
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill design-system-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a game design document for one system in isolation often produces contradictions with other systems, missing sections, and untestable requirements. This Skill walks you through each required GDD section collaboratively, gathering context from existing design docs first so the result stays consistent with the rest of the project. ## Core Features & Use Cases - Guided Section Cycle: Walks through Overview, Player Fantasy, Detailed Design, Formulas, Edge Cases, Dependencies, Tuning Knobs, and Acceptance Criteria with a draft-approve-write loop per section. - Context Gathering: Reads the game concept, systems index, entity registry, and dependency GDDs before designing, surfacing locked cross-system facts and past failure patterns. - Retrofit Mode: Fills only missing or placeholder sections of an existing GDD without overwriting completed content. - Specialist Delegation: Consults roles like systems-designer, creative-director, and qa-lead for formulas, fantasy framing, and testable acceptance criteria. - Use Case: After mapping your game's systems, run it on the movement system to produce a complete, registry-consistent GDD at design/gdd/movement.md with formulas and Given-When-Then acceptance criteria. ## Quick Start Ask the AI to design the movement system GDD using the design-system skill and approve each section as it is drafted.

Frequently Asked Questions about design-system

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

FAQPage Schema
How do I write a game design document for a single system?

Invoke the skill with a system name, and it reads your game concept, systems index, and dependency GDDs before walking you through each required section. Each section follows a draft, approval, and incremental write cycle into design/gdd/[system-name].md.

How to fill in missing sections of an existing GDD?

Use retrofit mode by passing the existing GDD file path. The skill scans for the eight required sections, reports which are complete or placeholder-only, and fills only the missing ones without modifying existing content.

What happens if I have no systems index or game concept yet?

The skill fails with a clear message directing you to run the brainstorm or map-systems skills first. It requires design/gdd/game-concept.md and design/gdd/systems-index.md to gather context before designing.

Does the skill prevent contradictions with other system GDDs?

Yes. It reads the entity registry and dependency GDDs, presents locked cross-system values before designing, and runs a registry conflict check after writing the Detailed Design and Formulas sections, surfacing mismatches immediately.

What are the limitations of the solo review mode?

Solo mode skips specialist agent consultations such as systems-designer and qa-lead, so formulas, edge cases, and acceptance criteria are drafted without expert review. The skill adds a note advising manual review before production.