review-all-gdds

Detect cross-document contradictions and design inconsistencies across game design documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies contradictions, stale references, ownership conflicts, formula incompatibilities, and emergent game-design failures that only appear when every system GDD is reviewed together, preventing architecture from being built on inconsistent or incoherent design documents.

Core Features & Use Cases

  • Cross-GDD Consistency Checks: Finds dependency asymmetries, rule contradictions, stale references, tuning-ownership conflicts, formula range mismatches, and acceptance-criteria clashes across system GDDs.
  • Game Design Holism: Detects dominant strategies, economic imbalances, cognitive overload, difficulty-curve mismatches, pillar drift, and player-fantasy conflicts that emerge only when systems are seen together.
  • Scenario Walkthroughs & Reporting: Performs summary scans, optional registry pre-loads, full reads, parallel consistency and design-theory analyses, scenario walkthroughs for multi-system interactions, and writes a dated cross-GDD review report while offering controlled write/update prompts to the user.

Quick Start

Run the review-all-gdds skill in full to produce a cross-GDD consistency and game-design holism report for files in design/gdd and optionally update the systems index.

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-document contradictions?

A cross-GDD review identifies contradictions by performing full Markdown reads of every system GDD and running parallel consistency analyses. It detects dependency asymmetries, stale references, tuning-ownership conflicts, and formula mismatches, then outputs a dated review report.

What is cross-GDD design holism and how does it prevent emergent game-design failures?

Cross-GDD design holism evaluates multi-system interactions to detect emergent failures like dominant strategies, economic imbalances, cognitive overload, and pillar drift. These design risks only appear when every system GDD is reviewed together rather than in isolation.

When do I need a cross-GDD consistency check during game development?

Cross-GDD consistency checks are needed during pre-architecture or post-revision review phases. Running a review before building architecture prevents implementation on inconsistent design documents, while post-revision checks catch stale references and acceptance-criteria clashes introduced by recent edits.

Can I use a registry file to pre-load entity data before reviewing GDDs?

Yes, the review process can optionally consult a design/registry/entities.yaml file. Pre-loading the registry provides entity-level context that improves the accuracy of dependency and ownership-conflict detection across system GDDs during the full read phase.

What's the best way to review GDD tuning and formula compatibility across multiple systems?

The best way to review tuning and formula compatibility is running a parallel design-theory analysis across all system GDDs. This detects formula range mismatches, tuning-ownership conflicts, and economic imbalances, then generates a dated cross-GDD review report with the findings.

Does the cross-GDD review automatically update the systems index?

The cross-GDD review does not automatically update the systems index. It offers controlled write and update prompts to the user, allowing you to review the dated report first before approving any optional systems-index updates.