gds-gdd

Create, update, and validate Game Design Documents through guided discovery and genre-aware checklists.

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill gds-gdd-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-gdd
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/gds-gdd
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill gds-gdd-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Game teams often start building without a clear, measurable design document, causing scope creep, missing genre conventions, and downstream confusion in architecture and production. This Skill coaches a designer through producing a dense, traceable Game Design Document (GDD) that serves as the canonical source of design intent. ## Core Features & Use Cases - Three intent modes: Create a new GDD from scratch, 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 game pitch against a game-type taxonomy (RPG, roguelike, fighting, platformer, and more) and loads genre-specific design sections and complexity requirements. - Traceability discipline: Enforces the chain from vision to pillars, core loop, mechanics, and development epics, with measurable mechanics and no engine-implementation leakage. - Use Case: A solo developer with a roguelike idea invokes the skill, confirms the game type, works through run structure and seed determinism sections, and ends with gdd.md, epics.md, and a decision log ready for the architecture phase. ## Quick Start Ask the AI to help you create a Game Design Document for your game idea using the gds-gdd skill.

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 idea and it runs a discovery conversation covering pillars, core loop, mechanics, and scope. It then drafts gdd.md from a canonical template, plus epics.md and a decision log, in a dedicated output folder.

How do I validate an existing GDD against a checklist?

Use the Validate intent: a validator subagent walks the GDD against a structured checklist covering quality, discipline, genre compliance, and structural integrity. Findings are rendered into HTML and Markdown validation reports with a grade.

Does the GDD skill support genre-specific design sections?

Yes. It matches your pitch against a game-types taxonomy CSV and loads a genre guide (RPG, roguelike, fighting, platformer, and others) that scaffolds the genre-specific design section. High-complexity genres trigger required-convention checks during validation.

What is the difference between a GDD and a PRD in this workflow?

The GDD is the primary design document and canonical source of game design intent, covering mechanics, levels, art, audio, and progression. A PRD is optional and exists only for formal functional requirements or external-tool compatibility.

Can the GDD skill run without an interactive user?

Yes. In headless mode it infers intent and game type from provided inputs, completes the work without prompting, and returns a JSON status block with artifact paths. Ambiguous intent produces a blocked status with a reason.

When should I not use the GDD skill for a game project?

Skip it when you need formal functional requirements in PRD format for external tools, or when you want to start building immediately with no design artifact. The skill itself suggests gds-prd or gds-quick-dev in those cases.