design-system

Generate a complete game design document for a single system.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/WindXRan/y3td --skill design-system-windxran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/WindXRan/y3td/tree/main/.claude/skills/design-system
Command: npx skills add https://github.com/WindXRan/y3td --skill design-system-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turns vague system ideas into a structured, section-complete GDD by guiding you through every required section, using existing documentation and dependency context to avoid contradictions.

Core Features & Use Cases

  • Guided, section-by-section authoring: Prompts you through Overview, Player Fantasy, Detailed Design/Rules, Formulas, Edge Cases, Dependencies, Tuning Knobs, and Acceptance Criteria.
  • Context-aware and dependency-respecting: Reads game concept and systems index, pulls cross-system facts from the entity registry, and surfaces past consistency failures and dependency constraints before you write.
  • Incremental editing with retrofit safety: In retrofit mode, fills only missing or placeholder sections and never overwrites existing section content.
  • Review modes and gated approvals: Supports review modes (full/lean/solo) and enforces approval prompts per section so changes are deliberate.

Quick Start

Use the command /design-system movement to walk through writing the full GDD for the movement system in your design/gdd folder.

Frequently Asked Questions about design-system

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

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

Generate a complete game design document through guided section-by-section authoring that walks through Overview, Player Fantasy, Rules, Formulas, Edge Cases, Dependencies, Tuning Knobs, and Acceptance Criteria to ensure section-complete and structured GDD output.

What is guided section-by-section authoring for game design documents?

Guided section-by-section authoring is a process that incrementally prompts you through required GDD sections like Player Fantasy, Formulas, and Acceptance Criteria. It enforces approval gates per section so changes are deliberate and structurally complete.

Can I retrofit an existing game design document without overwriting content?

Yes, you can retrofit an existing game design document safely. Retrofit mode fills only missing or placeholder sections and strictly enforces non-overwrite rules to preserve your existing section content.

How does dependency mapping work when designing a game system?

Dependency mapping works by reading the game concept and systems index to extract cross-system facts from the entity registry. It surfaces past consistency failures and dependency constraints before you write, preventing cross-system contradictions.

What format should formulas and acceptance criteria follow in a GDD?

Formulas in a GDD should use formula variable tables, while acceptance criteria must be testable. The process enforces section-specific completion formats to ensure formulas are mapped correctly and criteria are verifiable.

What review modes are available for incremental GDD writing?

Incremental GDD writing supports full, lean, and solo review modes. These modes enforce approval prompts per section, ensuring changes are deliberate and match your desired level of review detail during the authoring cycle.