ikemen-forge

Analyze character balance — compare frame data, damage output, and identify balance issues across the roster

Create a new IKEMEN Go character named "$ARGUMENTS".

Diagnose and fix problems with your IKEMEN Go project — crashes, missing files, broken references, and common errors

Prepare IKEMEN Go project for distribution: "$ARGUMENTS"

Initialize a new IKEMEN Go fighting game project with complete directory structure, configuration files, and default assets

Use this agent when creating or editing animation files (.air), designing collision boxes (hitboxes/hurtboxes), timing animation frames, or mapping sprites to animation actions. Examples: <example> Context: User needs animations for a new character user: "Create the animation file for my warrior character with all basic animations" assistant: "I'll launch the animation-smith to create a complete .air file with idle, walk, jump, attack, and hit reaction animations." <commentary>Complete .air file creation requires knowledge of frame timing, collision boxes, and sprite group conventions.</commentary> </example> <example> Context: User wants to adjust hitboxes user: "The heavy punch hitbox feels too small, it misses when it should hit" assistant: "I'll use the animation-smith to analyze and adjust the Clsn1 boxes on the heavy punch active frames." <commentary>Hitbox tuning requires understanding collision box coordinates and visual alignment.</commentary> </example>

Use this agent when analyzing character balance, comparing frame data across the roster, identifying overpowered or underpowered elements, or tuning damage values and move properties. Examples: <example> Context: User thinks a character is too strong user: "My grappler seems way too powerful compared to the other characters" assistant: "I'll launch the balance-analyst to compare frame data, damage output, and matchup spread across your roster." <commentary>Balance analysis requires cross-character comparison of stats, frame data, and damage potential.</commentary> </example> <example> Context: User wants to tune combo damage user: "Combos are doing too much damage, players die in one combo" assistant: "I'll use the balance-analyst to audit combo damage, implement scaling, and set appropriate damage caps." <commentary>Damage system tuning requires understanding scaling, HitDef values, and combo theory.</commentary> </example>

Use this agent when designing a new character from concept to implementation — generating all required files (.def, .cns, .cmd, .air), choosing character archetypes, setting stats, and creating a complete playable character. Examples: <example> Context: User wants to create a new fighting game character user: "I want to create a ninja character with fast attacks and shuriken projectiles" assistant: "I'll launch the character-architect to design your ninja from concept through all required files." <commentary>Full character creation from concept requires coordinating .def, .cns, .cmd, .air, and understanding archetypes.</commentary> </example> <example> Context: User needs a boss character for their game user: "Create a final boss character that's powerful and intimidating" assistant: "I'll use the character-architect to design a boss with enhanced stats, super armor, and multi-phase mechanics." <commentary>Boss design requires archetype knowledge and stat tuning beyond normal characters.</commentary> </example>

Use this agent when diagnosing problems, fixing errors, analyzing crash logs, validating file syntax, or troubleshooting IKEMEN Go issues. Examples: <example> Context: Game crashes on startup user: "My game crashes when I try to load my new character" assistant: "I'll launch the debug-detective to analyze the crash, validate all character files, and identify the root cause." <commentary>Crash diagnosis requires systematic file validation and error pattern recognition.</commentary> </example> <example> Context: Character behaves incorrectly user: "My character gets stuck in the air after using the special move" assistant: "I'll use the debug-detective to trace the state flow and find the missing physics/state transition." <commentary>State machine debugging requires understanding state flow, physics, and transition logic.</commentary> </example>

Use this agent when writing Lua scripts for IKEMEN Go — custom game modes, story mode with cutscenes, arcade paths, custom menus, or advanced game logic. Examples: <example> Context: User wants a story mode user: "Create a story mode with cutscenes between fights for my game" assistant: "I'll launch the lua-scripter to create a story mode Lua script with dialogue system, cutscenes, and branching paths." <commentary>Story mode requires Lua scripting for cutscenes, dialogue, fight sequencing, and narrative flow.</commentary> </example> <example> Context: User wants a custom game mode user: "Add a boss rush mode where you fight all bosses in sequence" assistant: "I'll use the lua-scripter to create a custom boss rush game mode with Lua." <commentary>Custom game modes are implemented entirely in Lua with IKEMEN Go's scripting API.</commentary> </example>

Use this skill when creating or editing animations (.air files), defining sprite sequences, setting up collision boxes (hitboxes and hurtboxes), managing sprite groups/images, or understanding the SFF sprite format. Covers .air file syntax, Clsn boxes, animation timing, looping, and sprite organization.

Use this skill when creating new characters, understanding character file structure, configuring character constants (life, attack, defense, movement), or working with .def and .cns files. Covers character definition files, constants, size parameters, velocity, and movement physics.

Use this skill when creating or editing command input files (.cmd), defining move inputs (quarter circles, dragon punches, charge moves), setting up the Statedef -1 command detection state, or configuring button mappings. Covers command notation, input windows, buffer timing, and move priority ordering.

Use this skill when setting up an IKEMEN Go project, configuring the engine, understanding project structure, or initializing a new fighting game. Covers engine download, folder layout, mugen.cfg configuration, and IKEMEN Go vs classic MUGEN differences.

Use this skill when analyzing or adjusting character balance, designing frame data, setting damage values, creating damage scaling systems, designing hitboxes for fair gameplay, or applying fighting game design theory. Covers frame data, damage systems, hitbox design, character archetypes, and competitive balance principles.