Skip to content

Design Review

Reviews a game design document for completeness, consistency and implementability before programmers start

Stars
32,965
Licence
MIT
Files
1 file

What it does

Once installed, the agent reviews one game design document (GDD) before it goes to programmers. It checks that required sections are present, that the numbers and facts don't contradict each other or a shared registry of project facts, and that the design can actually be built. It can run in a full mode that delegates to specialist sub-agents, a lean single-session mode, or a solo mode for use inside other skills. It also skips re-reviewing a document that is byte-identical to its last review.

Great for

  • Game studios or solo developers who write design docs before implementation
  • Design leads who want a consistent checklist applied to every GDD
  • Teams using the Claude Code Game Studios template who want review logs saved under design/gdd/reviews

Skip it if

  • Non-game documents or projects without GDD-style design docs, since the section rules are specific to that format
  • Final sign-off on design quality: the review is an automated assessment and can miss defects, and the skill itself says a prior pass is not proof of completeness
  • Projects that do not want the agent writing review logs and registry-related files into the repository, since it has Write and Edit permissions

Try asking

  • “Review design/gdd/combat-system.md before handing it to the programmers”
  • “Run a lean review of design/gdd/economy.md and check it against the entity registry”
  • “Review the inventory GDD in solo mode from inside another skill”
Step-by-step guide: how to use Design ReviewInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    design-review.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip design-review.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip design-review.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Pass the document path and mode explicitly, for example --review lean, so the depth of review is predictable; --review overrides the older --depth flag
  • Keep the registry (design/registry/entities.yaml) up to date so cross-document checks are meaningful
  • Treat the verdict as a checklist to act on, and still have a human designer read the flagged findings

What's inside

  • SKILL.md

Redistributed unmodified from Donchitos/Claude-Code-Game-Studios under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.