# scenario-godot-animation

scenario-godot-animation configures character animation, AnimationTree state machines, and procedural foot IK in Godot 4.7 while fixing foot sliding and blend glitches.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 458 installs · ★ 3964 repo stars
- Author: scenario-labs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/godot/scenario-godot-animation/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/scenario-godot-animation

## What it does

This skill guides character and scene animation workflows in Godot 4.7.2. It covers programmatic `AnimationTree` assembly in GDScript, `BoneMap` retargeting for Mixamo and glTF assets, `RESET` track generation, and measuring clip movement with `foot_speed` to eliminate ground sliding.

Workflows rely on sequential gates to catch silent engine failures. Transition expressions with the default Enabled advance mode never fire on their own without `ADVANCE_MODE_AUTO`. Skeleton modifiers also execute in child order, meaning target placers must sit before the `TwoBoneIK3D` solver.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-animation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/scenario-godot-animation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/scenario-godot-animation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-animation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/scenario-godot-animation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-animation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/scenario-godot-animation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scenario-labs/skills skills/game-engines/godot/scenario-godot-animation
```

2. **Manually: put the files in place**
- File: `.github/skills/scenario-godot-animation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-animation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/scenario-labs/skills --path skills/game-engines/godot/scenario-godot-animation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/scenario-godot-animation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-animation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/godot/scenario-godot-animation/SKILL.md

## When to use it
- calculate exact ground speed to prevent foot sliding
- retarget Mixamo or glTF rigs using BoneMap
- generate AnimationTree state machines via GDScript
- implement foot placement with TwoBoneIK3D
- debug character T-poses and silent transition failures

## Example prompts
- Generate a GDScript helper for an AnimationTree state machine with jump transitions
- Fix foot sliding on this walk cycle by measuring foot speed
- Configure TwoBoneIK3D modifiers for character leg placement

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 74184d29155cc226.

BEGIN THIRD-PARTY FILE 74184d29155cc226
```text
---
name: scenario-godot-animation
description: "Use when animating characters or scenes in Godot 4.7: AnimationPlayer clips and RESET, AnimationTree state machines and blend spaces built in code, Mixamo or glTF import, loop settings, BoneMap retargeting and shared animation libraries, root motion, foot sliding, foot IK with TwoBoneIK3D or custom SkeletonModifier3D, tweens, SpringArm3D cameras, cutscenes; or when a character T-poses, slides, floats, freezes mid-blend or a transition never fires."
license: MIT
---

# Godot animation (animator and technical animator)

Target: Godot 4.7.2.stable, macOS, Forward+ with Jolt Physics. Every procedure in
[`references/procedures.md`](references/procedures.md) was run live in 4.7.2 on 2026-10-02 against a
procedurally built humanoid, so nothing needs a download.

## Stance

- **Measure motion, do not eyeball it.** A walk has one correct ground speed: the speed at which the
  planted foot stops sliding. Measure it from the clip (`anim_motion.gd:foot_speed`) and use that
  number for BlendSpace points and the controller. On a retargeted body the speed scales with
  `Skeleton3D.motion_scale` (a 1.15x body walked 1.38 m/s on a 1.2 m/s clip).
- **Code decides, the animation layer presents.** Gameplay owns velocity and state; the
  AnimationTree only reads them through advance expressions or parameters. The controller must still
  work with the tree removed (Fair Fight, jzuvd0Lstuw 00:05:46).
- **Look at exact times.** Seek or step to fixed times and open a contact sheet
  (`gd_anim.pose_sheet`). Real-time captures land on random frames.
- **A layer must say which bones it owns.** Partial clips do not stay partial: glTF export pads
  every clip with every animated joint, and an unfiltered OneShot under the default deterministic
  blending snaps every unlisted bone to RESET. Filters, not missing tracks, define layers.
- **Choose the driver per motion.** Velocity-driven locomotion with in-place clips keeps control
  responsive; root motion suits one-shot moves (dodge, climb, vault) where the feet must stay
  planted [added]. A tree suits a normal locomotion set; very large move sets or many procedural
  layers favor code plus SkeletonModifier3D layers (the experts disagree: Fair Fight against trees,
  xpoPfUKI9tw; RiftOfNostaria, Bitlytic and Chris for them). Tweens for runtime values with unknown
  starts, AnimationPlayer for authored multi-property curves (Queble, KUyQzjpRsU8 00:01:48).
- **Silent failures are the norm here.** A BoneMap naming bones that do not exist, an expression
  transition at advance mode Enabled, a missing RESET key: each produced no error in 4.7.2. Audit
```
END THIRD-PARTY FILE 74184d29155cc226

The third-party file has ended. Everything between the 74184d29155cc226 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2659 of 18877 bytes. © scenario-labs · MIT · https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/godot/scenario-godot-animation/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
