review-all-gdds

Review all game design documents for cross-GDD contradictions and holistic design issues.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill review-all-gdds-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-all-gdds
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/review-all-gdds
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill review-all-gdds-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents brittle game development by identifying cross-document inconsistencies between system GDDs, including stale references, conflicting rules, ownership disputes, and design-theory violations that only appear when you review everything together.

Core Features & Use Cases

  • Cross-GDD Consistency Review: Detects dependency asymmetry, rule contradictions, stale references, ownership conflicts in tuning knobs, formula compatibility issues, and acceptance-criteria conflicts across all GDDs.
  • Game Design Holism Checks: Flags competing progression loops, cognitive overload risk, potential dominant strategies, economic imbalance, difficulty curve mismatches, pillar drift, and player-fantasy incoherence.
  • Cross-System Scenario Walkthrough: Walks key multi-system gameplay moments to find interaction-boundary failures like race conditions, undefined state transitions, reward conflicts, and compounding difficulty spikes.
  • Run-When Guidance: Intended to be executed after MVP-tier GDDs are individually approved and before architecture begins.

Quick Start

Run review-all-gdds with the argument "full" after all MVP system GDDs are written and approved.

Frequently Asked Questions about review-all-gdds

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

FAQPage Schema
How do I check game design documents for cross-system contradictions?

Cross-system contradictions in game design documents are checked by reviewing all GDD markdown files together to detect dependency asymmetry, stale references, rule conflicts, and ownership disputes across multiple systems.

When should I review all GDDs for holistic design issues?

Holistic design issue reviews should be executed after MVP-tier system GDDs are individually approved and before systems architecture begins, ensuring dependencies, progression loops, and player fantasy are consistent.

How do I find economic balance and progression loop conflicts across multiple game systems?

Economic balance and progression loop conflicts are found by running pairwise rule, economy, and design-theory checks across all relevant GDDs to flag competing loops, dominant strategies, and difficulty curve mismatches.

What is a cross-system scenario walkthrough in game design?

A cross-system scenario walkthrough walks key multi-system gameplay moments to identify interaction-boundary failures like race conditions, undefined state transitions, reward conflicts, and compounding difficulty spikes.

Can I validate bidirectional dependencies using an entity registry baseline?

Yes, bidirectional dependencies and references can be validated optionally using an entity registry baseline while scanning all relevant GDD markdown files to ensure structural consistency across systems.

What are the limitations of running a full GDD consistency check?

A full GDD consistency check is intended strictly for post-MVP phases and requires reading all relevant markdown files, meaning it cannot validate incomplete systems or substitute for individual GDD approval processes.