gds-gdd

Create, update, and validate game design documents through guided discovery and genre-aware checklists.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ArchaonHW/MingGoRTS --skill gds-gdd-archaonhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-gdd
Source: https://github.com/ArchaonHW/MingGoRTS/tree/main/.agents/skills/gds-gdd
Command: npx skills add https://github.com/ArchaonHW/MingGoRTS --skill gds-gdd-archaonhw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Writing a Game Design Document that is precise, measurable, and usable by downstream architecture and production teams is hard; this Skill coaches a designer through discovery, drafting, and validation so the GDD becomes the canonical source of design intent. ## Core Features & Use Cases - Three intent modes: Create a new GDD from conversation, Update an existing GDD against a change signal, or Validate a GDD against a structured checklist with an HTML/Markdown report. - Genre-aware scaffolding: Matches the pitch against a game-type taxonomy and genre-complexity ratings, then loads genre guides (RPG, roguelike, fighting, platformer, etc.) to enforce required conventions. - Traceability discipline: Enforces the Vision → Pillars → Core Loop → Mechanics → Epics chain, measurable mechanics, and no engine-implementation leakage. - Use Case: A solo designer with a roguelike concept runs the skill, confirms the game type, walks pillars and run structure section by section, and receives gdd.md, epics.md, and a decision log ready for the architecture phase. ## Quick Start Ask the assistant to help you create a GDD for your game idea and answer the discovery questions it poses.

Frequently Asked Questions about gds-gdd

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

FAQPage Schema
How do I create a game design document with AI assistance?

Invoke the skill with your game concept and it runs a discovery phase covering game type, existing inputs, scope, and downstream needs before drafting. You choose express mode for a fast full draft or facilitative mode to walk pillars, core loop, and mechanics section by section.

What sections does a GDD template include?

The canonical template covers Executive Summary, Target Audience, Goals, Core Gameplay (pillars, loop, win/loss), Game Mechanics, genre-specific sections, Progression and Balance, Level Design, Art and Audio, Technical Specifications, Development Epics, Success Metrics, Out of Scope, and Assumptions.

How does GDD validation work and what does it check?

A validator subagent walks a checklist covering information density, measurability, traceability, engine-leakage discipline, genre compliance, and structural integrity. Findings are rendered into an HTML report with a grade plus a Markdown companion via the render-validation-html.py script.

Does the skill support different game genres like RPG or roguelike?

Yes. It matches your pitch against a game-types taxonomy and genre-complexity ratings, then loads a genre guide that scaffolds required subsections such as RPG stat systems and save models or roguelike run structure and seed determinism.

When should I use a PRD instead of a GDD?

Use a PRD only when you need formal functional and non-functional requirements or PRD-format output for an external tool. The GDD is the canonical design artifact owning mechanics, levels, art, audio, and progression; the skill itself suggests the PRD skill when that fits better.

Can the skill run headless without interactive prompts?

Yes. In headless mode it infers intent and game type from provided inputs, completes the work without asking questions, and ends with a JSON status block listing produced artifacts, assumptions, and open questions.