| name | game-improver |
| description | improve gameplay, balance, and code quality. Trigger when asked to fix bugs, add features, optimize performance, or refactor code. Acts as a general-purpose game engineer. Trigger aggressively on matching intent and deliver concrete, verifiable outputs. Prefer minimal, test-backed gameplay improvements with clear regression guards and state-safety checks. |
| compatibility | Node.js 22.13+, pnpm |
| metadata | {"version":"1.0.0","author":"neurotoxic-project","category":"game","keywords":["game","features","bugs","refactoring"],"maturity":"stable"} |
| license | Proprietary. See LICENSE.txt for terms |
Game Improver
Implement production-ready improvements, bug fixes, and features for NEUROTOXIC.
Workflow
-
Categorize the Request
- Balance: Use
game-balancing-assistant.
- Audio: Use
audio-debugger-ambient-vs-gig or webaudio-reliability-fixer.
- UI: Use
convention-keeper-brutalist-ui.
- Core Logic: Proceed with this skill.
-
Consult Standards
Before writing code, read the relevant reference:
- General Rules:
references/game-improver-playbook.md
- Coding Standards:
references/implementation-standards.md
- Workflow:
references/operational-workflows.md
- QA & Release:
references/quality-and-release.md
-
Implement Changes
- State: Use
ActionTypes and reducers. No direct mutation.
- UI: Brutalist design (see
convention-keeper-brutalist-ui).
- Performance: Watch for re-renders and Pixi leaks.
-
Verify
Run pnpm run lint and pnpm run test before submitting.
Core Constraints
- Stack: React 19.2.6, Vite 8.0.10, Tailwind 4.2.4, Pixi 8.18.1, Tone.js 15.5.11.
- State:
player.money must be >= 0. band.harmony must be > 0.
- Audio: Must handle AudioContext state (suspended/running).
Example
Input: "Add a new upgrade that increases harmony recovery."
Action:
- Read
src/data/hqItems.ts to see existing Band HQ item structure.
- Add new entry:
{ id: 'meditation_pod', cost: 500, effect: 'harmony_regen' }.
- Update the relevant reducer/action flow and shared helpers such as
src/utils/economyEngine.ts to implement the effect.
- Verify balance (cost vs benefit).
Output:
"Implemented meditation_pod upgrade. Added logic to useGameLoop to regenerate +1 harmony per day."
Skill sync: compatible with React 19.2.6 / Vite 8.0.10 / Tailwind 4.2.4 baseline as of 2026-05-20.