gym

Run interactive Tokénmon gym leader battles with turn-based move selection and party switching.

24|6|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/ThunderConch/tkm --skill gym-thunderconch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gym
Source: https://github.com/ThunderConch/tkm/tree/main/skills/gym
Command: npx skills add https://github.com/ThunderConch/tkm --skill gym-thunderconch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns token-based progress into a structured, turn-by-turn gym battle experience where you choose moves and manage party switches safely through Claude Code’s UI.

Core Features & Use Cases

  • Turn-Based Gym Battles: Challenges a gym leader with sprite/HP status updates, guiding each turn via action-selection prompts.
  • Move Selection with Guardrails: Lets you pick only from available moves (slots 1–4), supports disabled moves, and re-prompts on invalid inputs to prevent accidental free-chat commands.
  • Switch & Surrender Mechanics: Provides separate, constrained flows for switching party members and confirming surrender, including forced switches when a member faints.
  • Animation-Driven Resolution: Pumps animation frames after each action call and then continues based on the returned JSON battle state.

Quick Start

Use the gym skill to start a gym battle by telling your assistant: “/tkm:gym 3”.

Frequently Asked Questions about gym

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

FAQPage Schema
How do I start a turn-based gym battle in Claude Code?

Turn-based gym battles run by loading battle state JSON and using AskUserQuestion prompts to guide move selection, party switching, and animation frame refreshes during each combat turn.

How does party switching work when a Tokénmon faints in battle?

When a Tokénmon faints, the battle loop triggers a forced party switching flow via AskUserQuestion prompts, requiring you to select a new active party member before the turn-based combat resumes.

Can I select disabled moves or chat freely during a gym battle turn?

Move selection is guarded to only allow available slots 1–4 and blocks disabled moves, re-prompting you on invalid inputs to prevent accidental free-chat commands from breaking the battle state.

Do I need a battle state JSON file to run gym leader combat?

Yes, running gym leader combat requires loading a battle state JSON file to execute battle-turn CLI commands and drive animation frame refresh and finalization strictly from the returned contract.

How are animation frames handled after executing a battle turn?

After executing a battle-turn CLI command, the gym skill pumps animation frames for visual updates and then continues the turn-based loop based entirely on the returned JSON battle state contract.