general-balance-tuner

Balances generals' stats by scoring maxStat and avg5 to tier rarity and recalculate EP.

3|Updated Mar 6, 2026

Search Tags:#automation #audit #balance #thresholds #ep #generals #rarity-tier

Ready to run

npx skills add https://github.com/eaglhuang/cocos_new --skill general-balance-tuner

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: general-balance-tuner
Source: https://github.com/eaglhuang/cocos_new/tree/main/.github/skills/general-balance-tuner
Command: npx skills add https://github.com/eaglhuang/cocos_new --skill general-balance-tuner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the balancing of generals' stats, automatically classifying rarity tiers and recalculating EP, to streamline pre-launch calibration and ongoing roster audits.

Core Features & Use Cases

Dual-axis scoring to derive rarityTier from maxStat and avg5, with consistent overrides and safety checks.
EP recalculation and eligibility validation to ensure attributes align with rarity.
Use Case: New generals can be auto-classified, full-roster rarity distributions audited, and manual overrides preserved.

Quick Start

Provide target General IDs and a mode (classify, rebalance, audit, or full) to run the tuner, which will reclassify rarity, recompute EP, validate aptitude, and suggest factor allocations.

Frequently Asked Questions about general-balance-tuner

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

FAQPage Schema

How do I automatically balance general stats and classify rarity tiers?▼

To balance general stats and classify rarity, apply a dual-axis scoring algorithm using maxStat and avg5 values. This recalculates EP and assigns rarity tiers based on predefined thresholds, streamlining both new general onboarding and full roster audits.

What is dual-axis scoring for rarity tier classification?▼

Dual-axis scoring derives a rarityTier by evaluating a general's maxStat and avg5 metrics simultaneously. This mechanism ensures balanced stat distribution alignment with rarity expectations while preserving any manual overrides or category-specific adjustments.

How do I run a full roster balance audit for generals?▼

Run a full roster balance audit by providing target General IDs and selecting audit or full mode. The tuner reclassifies rarity, recomputes EP, validates aptitude eligibility, and suggests factor allocations across the entire roster.

Can I preserve manual rarity overrides during automated EP recalculation?▼

Yes, manual rarity values and category overrides are preserved during automated EP recalculation. The system enforces these safety checks to ensure attributes align with rarity without overwriting manually set classifications.

Do I need specific JSON files to classify general rarity tiers?▼

Yes, you need rarity-thresholds.json for scoring thresholds, generals.json for general data, and GeneralUnit.ts type definitions. These files guide the dual-axis calculations and enforce category overrides during rarity classification.

What is the best way to recalculate EP and validate general aptitude?▼

The best way to recalculate EP and validate aptitude is using a rebalance or full mode tuner. It applies dual-axis scoring to recompute EP values, validates attribute eligibility against rarity tiers, and suggests factor allocations.