consistency-check

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

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/dnkrow/skill --skill consistency-check-dnkrow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: consistency-check
Source: https://github.com/dnkrow/skill/tree/main/claude-global/consistency-check
Command: npx skills add https://github.com/dnkrow/skill --skill consistency-check-dnkrow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents design drift by finding entities, items, formulas, and constants that disagree across multiple GDD documents, so downstream architecture decisions don’t get poisoned by contradictions.

Core Features & Use Cases

  • Cross-document consistency scan: Compares all registered entity/item/formula/constant values against what GDDs declare, detecting conflicts where the same named element has different stats.
  • Grep-first performance: Loads the registry once, then searches only relevant GDD snippets with targeted grep context instead of fully reading every document.
  • Actionable conflict handling: Produces a clear PASS/CONFLICTS report with deep investigation steps for conflicts and optional registry correction guidance.

Quick Start

Run /consistency-check in full mode to scan all registered entries against all design/gdd/*.md files and get a conflict report.

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 inconsistencies across multiple game design documents?

Cross-document consistency checking scans GDD files against an entity registry to detect contradictions. It compares registered entities, items, formulas, and constants to find where the same named element has different stats across documents.

What is the best way to prevent design drift before architecture?

Preventing design drift requires cross-document validation that catches conflicting stats and values before architecture begins. This tool identifies disagreements across multiple GDDs so downstream decisions aren't poisoned by contradictions.

How do I validate shared stats and formulas across local GDD markdown files?

Validating shared stats across GDD markdown files requires loading a central entity registry and scanning documents with targeted grep. This extracts relevant context to compare declared values against registered constants and formulas.

Does cross-document validation require reading every GDD file completely?

Cross-document validation uses a grep-first approach that loads the registry once and searches only relevant GDD snippets. It performs deep reads exclusively for detected conflicts, avoiding the need to fully read every document.

Can I use this consistency checker without a registered entities.yaml file?

The consistency checker requires a populated entity registry at design/registry/entities.yaml. Without this baseline file containing registered entities, items, formulas, and constants, there is no reference to validate the GDD markdown files against.

What format does the cross-GDD conflict report use?

The conflict report provides a clear PASS or CONFLICTS status. For failures, it includes deep investigation steps for the detected conflicts and optional registry correction guidance to resolve the design drift.