consistency-check

Detect mismatched entity definitions between registry YAML and GDD markdown files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates silent mismatches between the central entity registry and the various Game Design Documents, preventing downstream architecture errors and wasted review cycles.

Core Features & Use Cases

  • Grep‑first scanning: Quickly locates only the relevant sections of GDDs that mention registered names, minimizing I/O.
  • Multiple modes: Full project scan, incremental scan since the last review, or targeted checks for a specific entity or item.
  • Conflict reporting: Generates a concise report of mismatched values and suggests registry corrections or document updates.
  • Integration with workflow: Designed to run after each GDD edit or before architecture generation to keep the design system in sync.

Quick Start

Run the consistency-check skill with /consistency-check to scan all design documents for mismatches.

Frequently Asked Questions about consistency-check

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

FAQPage Schema
How do I check for design inconsistencies across Game Design Documents?

To check design inconsistencies across GDDs, compare entries in the central entity registry with GDD markdown files using targeted grep scans. This detects mismatched entity, item, formula, and constant definitions to prevent architecture errors.

What is a grep-first conflict detection scan for GDD files?

Grep-first conflict detection scans quickly locate only relevant GDD sections mentioning registered entity names, minimizing I/O while identifying mismatched definitions between the registry and design documents.

Can I run an incremental consistency check on a specific entity in a registry?

Yes, you can run an incremental consistency check on a specific entity. The system supports full project scans, incremental scans since the last review, or targeted single-item checks to locate relevant GDDs and detect conflicts.

When should I scan my entity registry against GDDs to prevent design conflicts?

You should scan your entity registry against GDDs after each GDD edit or before architecture generation. Running consistency checks at these points keeps the design system in sync and prevents wasted review cycles.

What is the best way to resolve mismatched constant definitions in a GDD?

The best way to resolve mismatched constant definitions is to generate a concise conflict report after scanning. This report highlights mismatched values and suggests registry corrections or document updates to synchronize the design.