consistency-check

Detects and reports inconsistencies between game design documents and a central entity registry using grep scanning and YAML parsing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents design drift by automatically detecting contradictions between your entity registry and individual Game Design Documents (GDDs), ensuring that stats, formulas, and item values remain synchronized across the entire project.

Core Features & Use Cases

  • Cross-Document Validation: Compares GDD content against a central registry to identify conflicting values for entities, items, and formulas.
  • Targeted Scanning: Uses a grep-first approach to minimize processing time by focusing only on relevant document sections.
  • Use Case: When updating a character's health stat in a core GDD, this skill identifies if other documents (like combat or level design GDDs) still reference the old, outdated value.

Quick Start

Run the consistency check skill to scan all design documents for conflicts against the current entity registry.

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

To check for inconsistencies across game design documents, you validate individual GDD content against a central entity registry to identify conflicting values for entities, items, and formulas. This prevents design drift caused by outdated references in multi-document projects.

Why do my game design documents have conflicting entity stats?

Game design documents have conflicting entity stats due to design drift when updates in a core GDD are not synchronized across other files. Detecting this requires scanning relevant document sections to find outdated values referenced in combat or level design GDDs.

How do I validate entity values in a YAML registry against GDD files?

You validate entity values by applying YAML parsing and grep-based text scanning across your design directory. This mechanism compares parsed registry attributes against text in individual game design documents to automatically detect and report contradictions in stats and formulas.

Can I scan a large design directory for data synchronization issues quickly?

Yes, you can scan a large design directory quickly because the validation uses a targeted grep-first approach to minimize processing time. By focusing only on relevant document sections, it efficiently identifies mismatches without parsing entire files unnecessarily.

What is cross-document validation for game development projects?

Cross-document validation for game development projects is the process of comparing individual game design documents against a central entity registry to ensure strict data synchronization. It ensures that stats, formulas, and item values remain consistent across the entire project.

Do I need a central entity registry to check GDD consistency?

Yes, you need a central entity registry to check GDD consistency because the validation process compares attributes parsed from YAML against the content in your design documents. Without this central registry, there is no baseline to detect cross-document contradictions.