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.