design-system

Guides section-by-section authoring of game design documents for individual game systems.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a complete, consistent game design document (GDD) for a single game system is hard: sections get skipped, formulas lack defined variables, and cross-system dependencies contradict each other. This Skill walks you through every required GDD section collaboratively, gathering context from existing design docs first and writing approved content incrementally to file. ## 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 for each section. - Context-Aware Authoring: Reads the game concept, systems index, entity registry, and dependency GDDs before designing, surfacing locked cross-system facts and past consistency failures. - Retrofit Mode: Fills only missing or placeholder sections in an existing GDD file without overwriting completed content. - Specialist Delegation: Consults creative-director, systems-designer, economy-designer, qa-lead, and art-director subagents for high-risk sections, with full/lean/solo review modes. - Use Case: Run it to design a combat system: it reads your systems index, checks engine feasibility constraints, drafts formulas with variable tables, and writes testable Given-When-Then acceptance criteria to design/gdd/combat.md. ## Quick Start Ask the AI to design the movement system GDD using the design-system skill and approve each drafted section as it is written to file.

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 drafting. Each of the 8 required sections goes through a draft-approve-write cycle, with content written incrementally to design/gdd/[system-name].md.

How do I fill in missing sections of an existing GDD?

Use retrofit mode by passing an existing GDD file path. The skill scans for the 8 required sections, lists which are complete versus missing or placeholder-only, and fills only the incomplete ones without overwriting existing content.

What happens if I haven't mapped my game systems yet?

The skill requires design/gdd/systems-index.md and fails with a message telling you to run the map-systems skill first. The systems index provides priority, layer, and dependency information that drives the design session.

Does the skill check technical feasibility against my game engine?

Yes, it maps the system category to an engine domain, reads configured engine reference docs and architecture decision records, and presents a feasibility brief with constraints and knowledge gaps before design begins.

What are the full, lean, and solo review modes?

Review modes control specialist subagent delegation. Full spawns specialists like systems-designer and qa-lead for key sections, lean only consults them for high-risk sections like Formulas and Acceptance Criteria, and solo skips all delegation.

How does the skill prevent contradictions between GDDs?

It reads the entity registry for locked cross-system facts and runs a registry conflict check after writing Detailed Design and Formulas sections. If a written value differs from a registered value, it surfaces the conflict immediately instead of continuing silently.