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.