godot-turn-system — Claude Code skill: what it does, how to install
Supplies agents with GDScript blueprints for turn-based combat in Godot. Essential when structuring initiative queues and action points.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-turn-system -a claude-codeWhat godot-turn-system does
The skill equips the agent with strict GDScript rules for turn-based mechanics in Godot. It separates combat architecture into discrete phased rounds, continuous ATB gauges, or timeline managers. Board state lives in a Dictionary rather than the node tree. Grid navigation relies on AStarGrid2D instead of AStar2D.
Action points require validation through can_perform_action() before spending. In multiplayer games, the server owns the turn clock and triggers automatic passes on timeout. Queue recalculation on every action is disallowed to prevent performance dips. Modifying tile solidity without invoking update() on AStarGrid2D immediately breaks path queries.
What it helps with
- build a phased turn queue with action point validation
- implement an active time battle gauge or timeline interrupt system
- handle authoritative server-side turn timeouts for multiplayer matches
- configure grid pathfinding using AStarGrid2D and obstacle updates
Example prompts for the agent
- Implement a round-based combat manager in Godot using action points and deterministic tie-breaking.
- Create an ATB gauge loop in GDScript that pauses execution when an actor is ready.
- Set up a server-authoritative turn timeout handler using the TurnManager singleton contract.
How to install godot-turn-system
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-turn-system -a claude-code2Manually: put the files in place
~/.claude/skills/godot-turn-system/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-turn-system/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-turn-system -a codex2Manually: put the files in place
.agents/skills/godot-turn-system/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-turn-system -a cursor2Manually: put the files in place
.cursor/skills/godot-turn-system/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-turn-system2Manually: put the files in place
.github/skills/godot-turn-system/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-turn-system -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-turn-systemManually: put the files in place
.devin/skills/godot-turn-system/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-turn-system -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-turn-system
How to install godot-turn-system in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-turn-system -a claude-code.
What does godot-turn-system do?
It provides Godot coding patterns for turn queues, action point economics, and battle timelines while enforcing clean architecture rules.
How does the skill handle multiplayer turn timeouts?
The server controls a dedicated timer and automatically issues a pass action when time expires, while clients only display the countdown.