design-review

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

1|Updated May 3, 2026

Search Tags:#technical writing #acceptance criteria #game design #consistency check #GDD review #dependencies validation #cross-system design

Ready to run

npx skills add https://github.com/imclab/xrA1-swarm --skill design-review-imclab

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/design-review
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill design-review-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents programmers from implementing incomplete or inconsistent game design documents by running a structured, standard-based review before development starts.

Core Features & Use Cases

Depth-controlled design scrutiny: Supports full, lean, or solo review modes to match time and delegation needs.
Standard checklist validation: Verifies required document sections like rules, formulas, edge cases, tuning knobs, and acceptance criteria.
Cross-system and implementability checks: Assesses internal consistency, dependency integrity (missing GDD files), and whether rules are precise enough to implement.

Quick Start

Run the design review on your document at design/gdd/your-gdd.md to verify completeness and implementability using full mode.

Frequently Asked Questions about design-review

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

FAQPage Schema

How do I review a game design document for completeness before coding?▼

Reviewing a game design document involves validating internal consistency and completeness against project standards, checking required sections like rules, formulas, edge cases, and acceptance criteria before passing the GDD to programmers.

What is cross-system dependency validation in GDD review?▼

Cross-system dependency validation in GDD review is the process of globbing dependency files on disk to verify that referenced design documents exist, ensuring internal consistency and integrity across interconnected game systems before implementation.

How do I check if my game design rules are precise enough to implement?▼

You check implementability by validating that the GDD contains precise formulas, explicitly defined edge cases, and clear acceptance criteria, ensuring the rules are structured enough for developers to code without ambiguity.

Can I run a lean GDD review without spawning specialist tasks?▼

Yes, you can run a lean or solo review mode to perform standard checklist validation and consistency checks without spawning specialist tasks, matching the scrutiny depth to your available time and delegation needs.

What is the best way to validate acceptance criteria in game design?▼

The best way to validate acceptance criteria in game design is to run a standard checklist validation against the GDD, ensuring the criteria are complete, internally consistent, and adhere to project design standards before coding starts.