review-all-gdds

Detect contradictions and design issues across multiple GDD Markdown files.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill review-all-gdds
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-all-gdds
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.claude/skills/review-all-gdds
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill review-all-gdds

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies cross-document contradictions, stale references, ownership conflicts, formula mismatches, and emergent game-design issues that only appear when multiple system GDDs are considered together, preventing inconsistent design from being baked into architecture.

Core Features & Use Cases

  • Multi-pass loading and scanning: fast summary extraction, optional registry pre-load, and full-document reads to limit token usage and focus scope.
  • Consistency checks: bidirectional dependency verification, rule contradiction detection, stale reference identification, tuning-knob ownership checks, and formula range compatibility analysis.
  • Game-design holism: progression loop competition, cognitive load assessment, dominant-strategy detection, economic loop mapping, difficulty curve alignment, pillar alignment, and player-fantasy coherence.
  • Cross-system walkthroughs and reporting: scenario-by-scenario interaction walks, severity categorization (Blocker/Warning/Info), user confirmation for report writing, optional systems-index updates, and session-state recording.
  • Use Case: run after MVP GDDs are drafted (or after a major revision) to surface blocking contradictions and design hazards before creating architecture.

Quick Start

Run the review-all-gdds skill with no arguments to perform a full cross-GDD consistency and design-theory review across the design/gdd directory.

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 for cross-document contradictions across multiple game design documents?

To review GDD consistency before architecture, scan your repository's design/gdd directory to detect cross-document contradictions, stale references, and formula mismatches. This validates design coherence across all system documents before structural implementation begins.

How do I validate game design coherence across multiple system GDDs?

Validating game design coherence across system GDDs involves mapping economic loops, assessing progression competition, and detecting dominant strategies. It checks pillar alignment and player-fantasy coherence to surface emergent design hazards before architecture.

When should I perform a cross-GDD consistency check in my game development pipeline?

You should perform a cross-GDD consistency check after drafting MVP GDDs or completing a major revision. Running this review before creating architecture prevents inconsistent design rules and formula mismatches from being baked into structural systems.

Can I automatically update my systems index after reviewing game design documents?

Yes, you can automatically update your systems index after reviewing game design documents. The review process produces a consolidated dated report and offers controlled file updates with user consent to maintain registry accuracy.

What is the best way to detect formula range compatibility issues in game design files?

The best way to detect formula range compatibility issues in game design files is to perform full-document reads across multiple GDD Markdown files. This compares tuning-knob ownership and analyzes formula ranges to identify mismatches.

Does cross-GDD review work with Markdown files stored in a single repository?

Yes, cross-GDD review works with Markdown files stored in a single repository. It applies to repositories containing design/gdd files, utilizing multi-pass loading and optional registry pre-load to limit token usage during full-document reads.