godot-2d-animation — Claude Code skill: what it does, how to install
Provides production-tested GDScript patterns for Godot 2D animation, covering AnimatedSprite2D sync, procedural squash and stretch, and skeletal rigs.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-animation -a claude-codeWhat godot-2d-animation does
The skill provides reference GDScript implementations for Godot 2D systems, targeting AnimatedSprite2D and AnimationPlayer nodes. It enforces strict rules against deprecated nodes like AnimatedTexture and prohibits controlling a sprite simultaneously from code and AnimationPlayer tracks. The one_frame_sync_fix.gd helper handles the one-frame visual glitch: calling advance(0) right after play() forces the engine to apply sprite transforms alongside properties like flip_h. This prevents delayed visual states.
For dynamic game feel, procedural_squash_stretch.gd handles velocity deformation and impact landing. Auxiliary scripts like skeleton_2d_rig_helper.gd and procedural_walker_2d.gd set up FABRIK and TwoBoneIK inverse kinematics. Managing Tweens through tween_lifecycle_manager.gd ensures previous tweens are terminated with kill(). An AnimationPlayer moving a CharacterBody2D must run on the Physics callback mode, or physics interpolation will stutter.
What it helps with
- eliminate one-frame display glitches when changing animation and
flip_hsimultaneously - apply procedural squash and stretch based on character physics velocity
- set up two-bone inverse kinematics for 2D character legs
- stop conflicting Tweens from fighting over the same sprite property
- decouple combat hitboxes and metadata from raw SpriteFrames visuals
Example prompts for the agent
- Fix AnimatedSprite2D desync on direction change using one_frame_sync_fix.gd
- Implement procedural squash and stretch for player landing with procedural_squash_stretch.gd
- Configure a 2D skeletal IK leg rig using skeleton_2d_rig_helper.gd
How to install godot-2d-animation
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-animation -a claude-code2Manually: put the files in place
~/.claude/skills/godot-2d-animation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-2d-animation/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-animation -a codex2Manually: put the files in place
.agents/skills/godot-2d-animation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-animation -a cursor2Manually: put the files in place
.cursor/skills/godot-2d-animation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-2d-animation2Manually: put the files in place
.github/skills/godot-2d-animation/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-animation -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-2d-animationManually: put the files in place
.devin/skills/godot-2d-animation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-animation -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-2d-animation
How to install godot-2d-animation in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-animation -a claude-code.
What does godot-2d-animation do?
It equips coding agents with GDScript patterns for Godot 2D animation, resolving frame-sync issues, procedural squash and stretch, and skeletal IK rigging.
Why does the skill require advance(0) after play()?
AnimatedSprite2D updates state on the next process tick by default. Calling advance(0) immediately synchronizes the new frame with simultaneous property changes like flip_h.