design-system

Create or retrofit a game design document for one system with cross-system consistency.

47|12|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/nuoyanruoshui/GodotGameFramework --skill design-system-nuoyanruoshui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/nuoyanruoshui/GodotGameFramework/tree/main/Godot/.claude/skills/design-system
Command: npx skills add https://github.com/nuoyanruoshui/GodotGameFramework --skill design-system-nuoyanruoshui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns the complex process of designing a single game system into a structured, context-aware workflow, preventing inconsistent decisions, missing requirements, and incomplete game design documents.

Core Features & Use Cases

  • Guided GDD authoring: Collaboratively develops a system document section by section, covering overview, player fantasy, rules, formulas, edge cases, dependencies, tuning knobs, and acceptance criteria.
  • Context and dependency analysis: Reads game concepts, system indexes, registries, related GDDs, engine references, and architecture decisions before asking design questions.
  • Validation and review: Supports full, lean, and solo review modes, performs cross-system consistency checks, identifies registry conflicts, and incorporates specialist feedback for mechanics, formulas, art, and QA.
  • Retrofit support: Fills missing or placeholder sections in existing GDDs without overwriting completed content.
  • Use Case: Use it to design a combat, UI, economy, or other game system while maintaining alignment with the project's pillars, dependencies, technical constraints, and testable acceptance criteria.

Quick Start

Invoke the design-system skill with a system name, such as design-system combat, and optionally select a review mode with --review full, --review lean, or --review solo.

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 without breaking cross-system consistency?

Guided GDD authoring develops a system document section by section while reading project context, dependency GDDs, and engine references beforehand to preserve cross-system consistency across rules, formulas, and acceptance criteria.

What is dependency analysis in game system design and when do I need it?

Dependency analysis in game system design reads game concepts, system indexes, registries, and related GDDs to identify conflicts before design questions are asked. It is needed when designing systems like combat, economy, or AI in projects with established documentation.

Can I retrofit missing sections in an existing game design document without overwriting completed content?

You can retrofit missing or placeholder sections in an existing game design document without overwriting completed content. The workflow fills gaps in overview, player fantasy, rules, formulas, and tuning knobs while preserving your existing work.

How to validate game mechanics and formulas against technical constraints and acceptance criteria?

Validate game mechanics and formulas using full, lean, or solo review modes that perform cross-system consistency checks, identify registry conflicts, and incorporate specialist feedback for mechanics, formulas, art, and QA to ensure testable acceptance criteria are met.

Does collaborative GDD authoring work for solo developers or only for teams with specialist review agents?

Collaborative GDD authoring works for solo developers through the solo review mode. While it supports specialist review agents for mechanics, formulas, art, and QA in team settings, solo mode allows individuals to validate rules and edge cases independently.

What are the limitations of retrofitting a game design document for an established project?

Retrofitting a game design document requires access to project context files, dependency GDDs, engine references, and architecture decisions. It is limited to projects with established design documentation and cannot generate missing dependencies or engine references that do not exist.