balance-check

Analyzes game balance data files to detect outliers, degenerate strategies, and progression issues.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill balance-check-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: balance-check
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/balance-check
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill balance-check-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game balance tuning is error-prone: a single overpowered weapon, an infinite resource loop, or a broken XP curve can ruin player experience, and these issues are hard to spot by reading raw data files. This Skill systematically audits balance data against design intent and reports concrete problems with prioritized fixes. ## Core Features & Use Cases - Domain-Specific Analysis: Runs targeted checks for combat (DPS, time-to-kill), economy (faucets/sinks, infinite loops), progression (XP curves, dead zones, power spikes), and loot (rarity distribution, pity timers). - Design-Document Baseline: Reads the GDD from design/gdd/ to compare actual values against intended tuning targets and expected ranges. - Structured Report with Fix Cycle: Outputs a health summary, outlier tables, and prioritized recommendations, then optionally walks you through fixing the highest-priority issue and re-verifying. - Use Case: After tweaking weapon stats in assets/data/, run a balance check to confirm no weapon now strictly dominates all others and that time-to-kill stays within the designed range at every power tier. ## Quick Start Run a balance check on the combat system and show me any outliers or degenerate strategies.

Frequently Asked Questions about balance-check

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

FAQPage Schema
How do I check game balance for combat and economy systems?

Invoke the balance check with a domain argument such as combat, economy, progression, or loot, or pass a file path directly. The Skill reads the relevant data files and GDD, runs domain-specific checks like DPS calculation and faucet/sink mapping, and returns a structured report.

What does a game balance analysis report include?

The report lists data sources analyzed, a health summary rated HEALTHY, CONCERNS, or CRITICAL ISSUES, a table of outliers with expected versus actual values, degenerate strategies found, progression curve analysis, and prioritized recommendations with suggested fixes.

Can I check balance for a specific data file instead of a whole system?

Yes. Pass a file path as the invocation argument and the Skill loads that file directly, inferring the balance domain from its content. Without any argument, it asks which system you want to check.

Does the balance check fix issues automatically?

No, it reports findings first, then offers options: walk through fixing the highest-priority issue interactively, save the report to design/balance/, or stop for manual review. After a fix, it can re-run checks to verify no new outliers were introduced.

What happens if a balance fix changes a value defined in a design document?

The Skill reminds you that the value is defined in a design document and recommends running the propagate-design-change skill on the affected GDD to find downstream impacts before committing the change.