Agent skill · software engineering · aiskillstore

combat-system-creator

Create and modify combat system components for SHINOBI WAY game following the dual-system architecture (CombatCalculationSystem + CombatWorkflowSystem). Use when user wants to add new combat mechanics, damage formulas, status effects, mitigation logic, turn phases, or refactor existing combat code. Guides through proper separation of pure calculations vs state management.

Why this skill is useful

Provides specific implementation patterns and interfaces for combat mechanics that the AI wouldn't reliably generate on its own.

What it needs

About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.

What this skill does

Combat System Creator - SHINOBI WAY Create combat system components following the dual-system architecture: pure calculations separated from state workflow. Architecture Principle CombatCalculationSystem: Pure functions, no mutations, returns complete results CombatWorkflowSystem: State management, applies calculated results, controls flow When to Use Add new damage calculations or formulas Create new status effects or mitigation mechanics Add new combat phases or turn logic Refactor existing combat code Balance or modify combat math Quick Reference Damage Pipeline (5 Steps) Mitigation Pipeline (Priority Order) Defense Formulas Type Flat Percent (Soft Cap) ------ ------ ------------------- Physical STR × 0.3 STR / (STR + 200) Elemental SPI × 0.3 SPI / (SPI + 200) Mental CAL × 0.25 CAL / (CAL + 150) Damage Properties Property Flat Def % Def ---------- ---------- ------- NORMAL ✅ (max 60%) ✅ PIERCING ❌ ✅ ARMORBREAK ✅ ❌ TRUE ❌ ❌ Workflow: Adding New Mechanics Step 1: Identify System Ask: Is this pure math or state management? CombatCalculationSystem CombatWorkflowSystem ------------------------ --------------------- Damage formulas Applying damage to HP Hit/miss/evasion rolls Turn order management Crit calculations Buff duration tracking Defense reduction Phase transitions Effect chance rolls Combat log generation Step 2: Design the Calculation Interface For new calculations, define the result interface: Step 3: Implement Pure Function Step 4: Implement Workflow Application Creating New Status Effects Effect Types Available Effect Interface DoT Damage Formula Creating New Combat Phases Existing Turn Phases Player Turn: 1. TURNSTART → Reset flags 2. UPKEEP → Toggle costs, passive regen 3. MAINACTION → Skill execution 4. DEATHCHECK → Victory/defeat 5. TURNEND → Mark turn complete Enemy Turn: 1. DOTENEMY → Process enemy DoTs 2. DOTPLAYER → Process player DoTs (through shield) 3. DEATHCHECKDOT → Check DoT kills 4. ENEMYACTION → AI skill selection + execution 5. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills aiskillstore/combat-system-creator

View the source on GitHub

Browse the @skills marketplace