godot-animation Skill for Claude Code: What It Does and How to Install It

Makes your coding agent choose between AnimationPlayer, AnimationTree and Tween in Godot 4.7, then write the GDScript for it.

Installs: 8.4K; on skills.sh
Stars: 6.4K; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

The skill explains when to use each Godot animation tool and shows four GDScript patterns: playing a clip and awaiting it, travelling between AnimationTree states, blending a 2D run direction, and tweening a UI element. It also lists 9 pitfalls, such as leaving AnimationTree.active false, wrong parameter paths and reusing a finished tween.

It triggers when you work with AnimationPlayer or AnimationTree nodes in a .tscn file, blend character states, animate sprite sheets or write Tweens. It bundles no scripts. It targets Godot 4.7 and points to one reference file for state machines, root motion, SpriteFrames and Tween easing.

Good for

Godot 4 developers animating characters with state machines and blend spaces
Developers adding UI pops, fades and one-off moves with create_tween()
Anyone whose AnimationTree or Tween silently does nothing and wants the usual causes checked

Install godot-animation

Claude Code

Copy this prompt.

Install the godot-animation skill in Claude Code. Run this command:

claude plugin marketplace add gamedev-skills/awesome-gamedev-agent-skills
claude plugin install godot@awesome-gamedev-agent-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The godot plugin installs 16 Godot skills; the gamedev plugin installs the router plus all 77 skills. The skills CLI and folder routes install only godot-animation, which does not need the router or the other skills.

From the project README. Source.

What's in the skill

When it loads

Animate in Godot 4.7 three ways: AnimationPlayer for keyframed clips (incl. Call Method tracks), AnimationTree with state machines and blend spaces for character animation, and Tween for short procedural/UI tweens via create_tween(). Use when working with AnimationPlayer/AnimationTree nodes in a .tscn, blending character states, sprite-sheet animation, or code-driven Tweens.

Sections in SKILL.md

When to use
Core workflow
Patterns
1. AnimationPlayer: play a clip and await it
2. AnimationTree state machine: travel between states
3. Blend space: blend run direction by a 2D parameter
4. Tween: fade and scale a UI element (code-driven)
Pitfalls
References
Related skills

Key facts

Author: gamedev-skills (repo owner of awesome-gamedev-agent-skills)
License: Apache-2.0 (LICENSE file and README badge agree)
Installs on skills.sh: 8,374 (Nov 2, 2026)
GitHub stars: 6,427 for the whole gamedev-skills/awesome-gamedev-agent-skills repo (Nov 2, 2026)
Last repo commit: Oct 28, 2026
What it includes: 2 files: SKILL.md and references/animation-tree-and-tween.md; no scripts
Targets: Godot 4.7 (SKILL.md)
Part of: godot plugin: 16 Godot skills in the manifest and in the repo tree

What it includes

AnimationPlayer for clips, AnimationTree for blending, Tween for short code moves
AnimationTree needs an AnimationPlayer to pull clips from. Tween is fire-and-forget.
Try: “Blend idle, walk and run for my CharacterBody2D with an AnimationTree”
Pick the tool
Use AnimatedSprite2D with SpriteFrames, or key the frame property in AnimationPlayer
Step 2 of the core workflow.
Sprite sheets
anim.play("attack") then await animation_finished
Writes GDScript into your project.
Write · Pattern 1: play a clip and await it
Set active = true and travel() between states from _physics_process
Uses the playback object at parameters/playback.
Write · Pattern 2: AnimationTree state machine
Set parameters/Move/blend_position from the input direction
Root is an AnimationNodeBlendSpace2D.
Write · Pattern 3: blend space
create_tween() with set_parallel for scale and fade
Sub-properties use a colon, as in modulate:a.
Write · Pattern 4: UI tween
9 common mistakes, from AnimationTree.active left false to the removed yield
Includes tween stalls when a node leaves the tree and Container children snapping back.
Pitfalls list
Depth guide: state transitions, root motion, one-shot nodes, call tracks and easing
Loaded when you need more than the main patterns.
Read · references/animation-tree-and-tween.md

From the official docs

Permissions

Low risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Your agent edits your project files
The skill gives GDScript patterns for your agent to write into your project. Use version control and review the diff. github.com
The godot plugin adds a script from another skill
The git tree has one Python script under skills/godot, in godot-nodes-scenes. godot-animation itself has 2 files, both Markdown. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Scopes	Reads and writes GDScript and scene files in your Godot project

Questions

What does godot-animation do?

It teaches your coding agent which Godot 4.7 animation tool to use and how to write it. It covers AnimationPlayer clips, AnimationTree state machines and blend spaces, and code-driven Tweens.

How do I install it?

Use the install box above. The README documents a Claude Code plugin named godot that installs all 16 Godot skills, and a skills CLI command for the whole repo. The box also gives a command for this skill alone.

Which Godot version does it target?

Godot 4.7. SKILL.md says the Container-safe offset_transform properties it recommends are for 4.7 and later, and that the old Tween node and yield are gone in 4.x.

Do I need the other godot skills or the router?

No. SKILL.md lists related skills such as godot-2d-movement and godot-ui-control, but it does not require them. The README describes a router skill that picks skills for you, which is optional.

Why does my AnimationTree do nothing?

SKILL.md lists two common causes: active is still false, or the parameter path does not match the node names exactly. It says a typo in the path silently does nothing.

Does it work in the Claude app, Codex or Cursor?

The README says the same SKILL.md files load in Claude Code, Cursor, Windsurf, Cline, Codex, Gemini CLI and GitHub Copilot, among others. The Claude app is not named in the README; Claude supports uploading a skill folder as a zip.

Is it safe?

It bundles no scripts, and it makes your agent write GDScript into your project. Our advice: use version control and review the diff. The godot plugin does include one Python script, in godot-nodes-scenes, which is a different skill.

Information

updated Nov 2, 2026

Repository: gamedev-skills/awesome-gamedev-agent-skills
Folder: skills/godot/godot-animation

gamedev-skills/awesome-gamedev-agent-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

README.md · github.com
marketplace.json · github.com
INSTALLATION.md · github.com
SKILL.md · github.com
animation-tree-and-tween.md · github.com