godot-animation-tree-mastery — Claude Code skill
Guides AI coding agents through Godot AnimationTree setups, StateMachine graphs, and blend spaces. Useful when building character movement and combat layers.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-animation-tree-mastery -a claude-codeWhat godot-animation-tree-mastery does
This skill instructs the agent on structuring Godot's AnimationTree without fighting the engine. Calling play() directly on AnimationPlayer disrupts tree execution and creates visible jitter, so runtime transitions must use travel() or relative parameter paths like "parameters/StateMachine/playback". The rules also require setting $AnimationTree.active = true explicitly during _ready.
A core focus is avoiding CPU overhead and cache invalidation. Writing parameters through set() every physics frame without checking for value changes causes stutter, which sync_parameter_manager.gd resolves with guarded updates. The guidelines steer directional inputs into BlendSpace2D, reserve BlendSpace1D for linear speed, and direct layered upper-body actions into Blend2 or Add2 nodes.
The repository includes dedicated GDScript templates for complex needs. Files like nested_state_machine.gd handle sub-machines for combat, while root_motion_animtree_sync.gd transfers root motion into CharacterBody. For long-running sequences, relying on auto_advance is prohibited to avoid corrupted character states when animations get interrupted.
What it helps with
- configure state transitions with
AnimationNodeStateMachinePlayback - blend directional movement in
BlendSpace2Dnodes - isolate upper-body animations using bone filter masks
- transfer root motion data into
CharacterBodymovement - prevent redundant parameter writes to stop cache drops
Example prompts for the agent
- Set up an AnimationTree for my 3D character using BlendSpace2D for strafing and travel() for state transitions
- Refactor my attack animations to use a nested state machine without direct AnimationPlayer play() calls
- Create an upper-body aiming overlay using BlendTree and bone masking
How to install godot-animation-tree-mastery
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-animation-tree-mastery -a claude-code2Manually: put the files in place
~/.claude/skills/godot-animation-tree-mastery/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-animation-tree-mastery/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-animation-tree-mastery -a codex2Manually: put the files in place
.agents/skills/godot-animation-tree-mastery/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-animation-tree-mastery -a cursor2Manually: put the files in place
.cursor/skills/godot-animation-tree-mastery/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-animation-tree-mastery2Manually: put the files in place
.github/skills/godot-animation-tree-mastery/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-animation-tree-mastery -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-animation-tree-masteryManually: put the files in place
.devin/skills/godot-animation-tree-mastery/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-animation-tree-mastery -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-animation-tree-mastery
How do I install godot-animation-tree-mastery in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-animation-tree-mastery -a claude-code. The skill file is placed in ~/.claude/skills/godot-animation-tree-mastery/SKILL.md.
What does godot-animation-tree-mastery do?
It equips your AI assistant with architecture rules and GDScript helper scripts for Godot's AnimationTree. It guides graph setups across state machines, blend spaces, and layered trees.
Why should I avoid calling play() on AnimationPlayer when using AnimationTree?
The AnimationTree node owns playback control over the AnimationPlayer. Direct play() calls bypass the graph logic and trigger animation stuttering.
