design-review

Review game design documents for completeness, consistency, and implementability.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill design-review-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/design-review
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill design-review-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews game design documents to catch missing sections, internal contradictions, implementation gaps, and broken dependencies so programmers and leads receive actionable, testable specs before development begins.

Core Features & Use Cases

  • Completeness checklist: Verifies presence of Overview, Player Fantasy, Rules, Formulas, Edge Cases, Dependencies, Tuning Knobs, and Acceptance Criteria.
  • Consistency & implementability analysis: Checks formulas, edge cases, cross-system interactions, and performance implications.
  • Adversarial specialist review: In full mode spawns parallel specialist subagents (game-designer, systems-designer, qa-lead, etc.) and synthesizes their findings via a senior creative-director.
  • Project-aware dependency checks: Validates declared dependencies against design/gdd/ files, reads CLAUDE.md and prior review logs, and surfaces disagreements for user adjudication.

Quick Start

Run the design-review skill on design/gdd/your-system.md with --depth full to produce a completeness and specialist-backed consistency report.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I validate a game design document for completeness and implementability?

Validating a game design document requires checking for missing sections, internal contradictions, and broken dependencies. The design-review process verifies completeness checklists, formulas, and cross-system interactions to produce actionable, testable specs before development begins.

What should be included in a game design document to pass a consistency review?

A consistency review requires your game design document to include Overview, Player Fantasy, Rules, Formulas, Edge Cases, Dependencies, Tuning Knobs, and Acceptance Criteria sections. It checks for internal contradictions, implementation gaps, and performance implications across cross-system interactions.

How do I check game design dependencies against repository files?

Checking game design dependencies involves validating declared dependencies against files in the design/gdd/ directory. The review reads CLAUDE.md and prior review logs to surface project-aware dependency conflicts and disagreements for user adjudication.

Can I run an adversarial specialist review on my game design document?

Running an adversarial specialist review is possible in full depth mode. It spawns parallel specialist subagents such as game-designer, systems-designer, and qa-lead, then synthesizes their findings via a senior creative-director to deliver a comprehensive consistency report.

Does the design review process require specific directory structures for GDD files?

The design review process applies to GDD files located in the design/gdd/ directory and related project docs. It relies on repository file reads and Glob/Grep checks to validate dependencies and ensure lore alignment across the project.

What are the limitations of automated game design document reviews?

Automated game design document reviews depend on repository file reads and interactive AskUserQuestion widgets to present next-step options. They cannot resolve dependency disagreements autonomously; instead, they surface conflicts for user adjudication and require existing project documentation to function.