design-review

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

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill design-review-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/design-review
Command: npx skills add https://github.com/imgamer/AILearn --skill design-review-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you catch missing or contradictory parts of a game design document early, reducing back-and-forth and preventing programmers from implementing an ambiguous or unbuildable spec.

Core Features & Use Cases

  • Design completeness audit: Checks required sections like overview, rules, formulas, edge cases, dependencies, tuning knobs, and acceptance criteria.
  • Internal consistency & implementability review: Validates formulas, edge-case logic, cross-system interactions, and whether details are precise enough to implement without guessing.
  • (Full mode) Adversarial specialist review: Delegates to domain specialists (e.g., game designer, systems designer, QA lead) and synthesizes a senior verdict, including explicit disagreement tracking.
  • Re-review awareness: Detects and references existing review logs to see what was previously blocked and whether it’s been resolved.
  • Dependency graph validation: Verifies that each declared dependency’s GDD file exists on disk to prevent downstream broken references.

Quick Start

Use the design-review skill to review a specific GDD path by running it on the document and setting the desired depth mode (full, lean, or solo).

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I check a game design document for completeness and internal consistency?

A game design document consistency check validates formulas, edge-case logic, and cross-system interactions to ensure details are precise enough to implement. It audits required sections like rules, dependencies, and acceptance criteria, producing a structured review verdict with blocking fixes.

How do I validate dependency references across related GDD files?

You can validate dependency references by running a dependency graph validation that verifies each declared dependency's GDD file exists on disk. This prevents downstream broken references by checking dependency integrity across related design documents.

When do I need to run a GDD review before engineering starts?

Run a GDD review during pre-production submission or after revisions to catch missing or contradictory parts early. An implementation readiness check reduces back-and-forth and prevents programmers from building an ambiguous or unbuildable spec.

Can I use an adversarial specialist review to find design gaps?

Yes, full mode delegates to domain specialists like game designers, systems designers, and QA leads to synthesize a senior verdict. This adversarial specialist review tracks explicit disagreements and identifies complex design gaps across cross-system interactions.

Does the design review detect what was previously blocked in older review logs?

Yes, re-review awareness detects and references existing review logs to see what was previously blocked. This checks whether specific issues have been resolved in the current GDD revision, ensuring continuous implementation readiness across iterative updates.

What is the difference between full, lean, and solo depth modes for systems analysis?

Full mode spawns specialist agent tasks for adversarial review, while lean and solo modes provide faster systems analysis without delegation. You set the desired depth mode when running the review on a specific GDD path to balance thoroughness and processing speed.