balance-schema-exporter

Convert game balance configurations into JSON schema and developer specification files.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/hoonzinope/skills --skill balance-schema-exporter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: balance-schema-exporter
Source: https://github.com/hoonzinope/skills/tree/main/game-skill/balance-schema-exporter
Command: npx skills add https://github.com/hoonzinope/skills --skill balance-schema-exporter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Balancing data and developer documentation often diverge, causing inconsistency between in-game parameters and external specs, which this skill centralizes.

Core Features & Use Cases

  • Generate a JSON schema describing balance parameters (upgrades, progression, currency) for tooling.
  • Produce a developer-facing technical spec to guide implementation and QA.
  • Use cases include exporting current balance configurations for deployment pipelines and keeping docs in sync with balance changes.

Quick Start

Use the scaffold tool to create BALANCE_SCHEMA.json and TECHNICAL_SPEC_FOR_DEV.md under .documents/game.

Frequently Asked Questions about balance-schema-exporter

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

FAQPage Schema
How do I export game balance configurations to a JSON schema for tooling?

Game balance configurations are transformed into a machine-readable JSON schema by running scaffold_doc.py, producing BALANCE_SCHEMA.json under .documents/game for tooling and pipeline integration.

What does a developer-facing technical spec for game balance parameters include?

A developer-facing technical spec documents balance parameters, upgrades, and progression rules to guide implementation and QA, produced as TECHNICAL_SPEC_FOR_DEV.md using the provided TEMPLATE.md for synchronization.

How do I keep developer documentation in sync with game balance changes?

Game balance changes are kept in sync with developer documentation by using a dated append mode via TEMPLATE.md, capturing updates over time to maintain consistency between in-game parameters and external specs.

Can I generate balance schemas for deployment pipelines without manual coding?

Balance schemas for deployment pipelines can be generated without manual coding by running scaffold_doc.py, which automates creation of JSON schemas and technical specs under .documents/game for integration and QA workflows.

Do I need any external dependencies to scaffold game balance documentation?

No external dependencies are required to scaffold game balance documentation; the skill operates independently using its own scripts, references, and assets to generate JSON schema and developer specification files.