consistency-check

Detect cross-document inconsistencies between game design documents and a central entity registry.

Updated Jul 22, 2025
One-click install
npx skills add https://github.com/MichaelSolati/mkai --skill consistency-check-michaelsolati
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: consistency-check
Source: https://github.com/MichaelSolati/mkai/tree/main/profiles/game-dev/skills/consistency-check
Command: npx skills add https://github.com/MichaelSolati/mkai --skill consistency-check-michaelsolati

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Game development teams often face costly rework when inconsistent data (like mismatched entity stats, item values, or formula definitions) slips through multiple game design documents (GDDs) and propagates to architecture and implementation. This Skill eliminates that risk by automatically scanning all GDDs against a central entity registry to catch conflicts early, before they require expensive fixes downstream.

Core Features & Use Cases

  • Cross-Document Conflict Detection: Compares all GDDs against the central entity registry to find mismatched stats, values, and formulas for shared entities, items, formulas, and constants.
  • Efficient Grep-First Scanning: Targets only relevant GDD sections that mention registered names instead of reading full documents, making checks fast even for large design libraries.
  • Use Case: After writing a new GDD for a game system, run this Skill to catch any inconsistencies with existing GDDs before moving on to architecture creation, saving hours of rework later.

Quick Start

Use the consistency-check skill to scan all current game design documents for cross-document inconsistencies in entity stats, item values, and formula definitions.

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

Detect cross-document inconsistencies in game design documents by scanning all GDDs against a central entity registry to identify mismatched entity stats, item values, and formula definitions before they propagate to architecture creation.

What is the best way to validate shared entity data across multiple GDDs?

Validating shared entity data across multiple GDDs is best handled by comparing registered names and values against a central entity registry, using a grep-first approach to target relevant sections and generate actionable conflict reports.

How do game design inconsistencies get caught before architecture creation?

Game design inconsistencies get caught before architecture creation by running consistency checks that scan GDDs for mismatched entities, items, formulas, and constants, providing a write-time safety net against downstream design errors.

Can I run a consistency check on just one specific entity in my game design documents?

You can run a targeted consistency check on specific entities or items in your game design documents, or perform full scans and incremental scans since the last review to catch design errors as your project evolves.

Why use a grep-first approach for cross-document validation in game development?

A grep-first approach for cross-document validation in game development minimizes unnecessary document reads by targeting only GDD sections that mention registered names, making consistency checks fast even for large design libraries.

When do I need to run a cross-GDD consistency check in my game development workflow?

You need to run a cross-GDD consistency check in your game development workflow after writing a new GDD for a game system to catch any inconsistencies with existing documents before moving on to architecture creation, saving hours of rework.