design-review

Reviews game design documents for completeness, consistency, and implementability before development handoff.

Updated Jul 22, 2025
One-click install
npx skills add https://github.com/MichaelSolati/mkai --skill design-review-michaelsolati
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/MichaelSolati/mkai/tree/main/profiles/game-dev/skills/design-review
Command: npx skills add https://github.com/MichaelSolati/mkai --skill design-review-michaelsolati

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Game design documents (GDDs) frequently contain missing sections, internal inconsistencies, or unimplementable rules that are only discovered late in the development cycle, leading to costly rework and delayed releases. This skill eliminates that risk by running a structured, multi-phase review of GDDs before they are handed off to programming teams.

Core Features & Use Cases

  • Completeness Validation: Checks GDDs against a standard 8-section checklist to flag missing required content like player fantasy, edge cases, and acceptance criteria.
  • Consistency & Implementability Audit: Verifies that formulas, rules, and cross-system references are clear, conflict-free, and ready for implementation without guesswork.
  • Adversarial Specialist Review (full mode): Spawns domain-specific expert agents (game designers, systems designers, QA leads, etc.) to surface hidden flaws from specialized perspectives that a single reviewer might miss. Use case: A game designer finalizing a new combat system GDD can run this review to catch balance issues, missing edge cases, and conflicts with existing game systems before sharing the document with engineers.

Quick Start

Use the design-review skill to evaluate your game design document at [path-to-your-gdd-file] for completeness, consistency, and implementability prior to development handoff.

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 before handing it to developers?

Checking a game design document for completeness involves verifying it against an 8-section checklist to flag missing required content like player fantasy, edge cases, and acceptance criteria before development begins.

What is an adversarial specialist review for game design?

An adversarial specialist review for game design spawns domain-specific expert agents, such as systems designers and QA leads, to surface hidden flaws from specialized perspectives that a single reviewer might miss during full mode validation.

How do I check for cross-system conflicts in my game design document?

Checking for cross-system conflicts in your game design document requires a consistency and implementability audit. This process verifies formulas, rules, and cross-system references to ensure they are clear and conflict-free for engineers.

Can I run a fast consistency audit on a game design document for a solo project?

Yes, you can run a fast consistency audit on a game design document for a solo project by configuring the analysis depth to solo or lean modes, which support quick single-session checks instead of comprehensive multi-phase reviews.

What are common limitations of automated game design document reviews?

Automated game design document reviews are limited by the configured analysis depth and the quality of the input document. Fast lean or solo modes prioritize speed over the comprehensive flaw detection achieved by full adversarial multi-agent reviews.