consistency-check

Detect cross-document inconsistencies between GDD entries and the central entity registry.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/packetalien/cursor-game-studios --skill consistency-check-packetalien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: consistency-check
Source: https://github.com/packetalien/cursor-game-studios/tree/main/.cursor/skills/consistency-check
Command: npx skills add https://github.com/packetalien/cursor-game-studios --skill consistency-check-packetalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect cross-document inconsistencies between GDD entries and the central entity registry. It uses a grep-first approach to read the registry once, then targets only the GDD sections that mention registered names, avoiding full-document reads unless a conflict needs investigation.

Core Features & Use Cases

  • Grep-first registry scan: reads the registry once, then scans GDDs for named entries to minimize data reads.
  • Conflict detection across entities, items, formulas, and constants: flags mismatched values and missing attribute references.
  • Registry health checks: identifies stale registry entries when source GDD values have changed and updates are pending.
  • Output and traceability: produces a conflict report with actionable recommendations for updates to the registry or source GDDs.

Quick Start

Run the consistency-check against design/gdd to generate a conflict report and suggested registry updates.

Frequently Asked Questions about consistency-check

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

FAQPage Schema
How do I detect cross-document inconsistencies between game design documents and an entity registry?▼

To check for stale registry entries, scan your GDD files for changed source values and compare them against the central registry. The process identifies pending updates and produces a review-ready report with actionable recommendations for synchronizing the registry or source GDDs.

What is the best way to validate entity attributes across multiple GDD files?▼

The best way to validate entity attributes across multiple GDD files is running a consistency check that targets only the sections mentioning registered names. It extracts nearby attributes, flags conflicts across entities and items, and outputs a review-ready conflict report without reading entire documents.

Can I filter consistency checks to target a specific entity or item in my GDDs?▼

Yes, you can filter consistency checks to target a specific entity or item in your GDDs. By applying optional filters like entity:<name> or item:<name>, the check limits its grep-first scan to relevant sections, producing a focused conflict report for the specified registry entries.

How do I identify stale registry entries when source GDD values have changed?▼

To identify stale registry entries when source GDD values have changed, run a consistency check across your design GDDs. It compares current source values against the central entity registry, flags mismatches, and generates a report with suggested registry updates to restore synchronization.

Does a grep-first consistency check require full-document reads of every GDD?▼

No, a grep-first consistency check does not require full-document reads of every GDD. It reads the registry once, scans only the GDD sections that mention registered names, and avoids full reads entirely unless a specific conflict requires deeper investigation.