scenario-godot-animation
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…
Install / Use
npx skills add scenario-labs/skills --skill scenario-godot-animationInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of scenario-godot-animation
scenario-godot-animation scores 86/100 on our quality scale, 2381st of 4,705 Development & Engineering skills we index.
Its SKILL.md is 18 KB long, well organised into 11 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-godot-animation is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-godot-animation compared with similar skills
All 4 of these similar skills score higher than scenario-godot-animation; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-godot-animation (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 73.0k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.5k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install scenario-godot-animation?
- Run
npx skills add scenario-labs/skills --skill scenario-godot-animation. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-godot-animation work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-godot-animation safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-godot-animation still maintained?
- The repository was last updated 35 days ago, so scenario-godot-animation is actively maintained.
Skill content
View source on GitHubname: 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 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 withSkeleton3D.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
after every import and every tree change. If a sibling skill named here is missing from your
available skills, load it with
skill_get(Scenario MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag the gap.
Establish first
Ask once, then run:
- Source of motion: Mixamo or other FBX, Blender glTF, mocap, hand-keyed in Godot, procedural only.
- Rig: humanoid (SkeletonProfileHumanoid fits) or custom; T-pose or A-pose rest; real Root bone or not.
- Locomotion model: velocity-driven (in-place clips) or root motion; target speeds if the design fixes them.
- Layers needed: upper-body actions, aim or look-at, foot IK on uneven ground, hit reactions.
- Characters sharing clips, and their height range.
- Cutscenes: length, camera count, whether gameplay must be frozen, dialogue system in use.
- Physics tick, renderer and target hardware (for IK and modifier cost).
Workflow with gates
-
Kit and project.
gd_anim.install_animkit(P); confirmproject.godothas Jolt for 3D and the brief's renderer. Gate: the kit's jobs returnok. -
Import. Name cycles with a loop hint (
Walk-loop), import once, then set options in the.importfile (gd_anim.set_import_options, P3) and run--import. Turn onanimation/import_rest_as_RESET. Gate:gd_anim.audithas no flags; every cycle loops; RESET exists. -
Retarget. Build the BoneMap from the imported bone names (
anim_import.gd:make_bonemap, P4);:becomes_on import. Gate: skeleton is%GeneralSkeleton, bones renamed, sampled poses within 2 mm of the source. -
Share. Import clips As Animation Library, give each body its own BoneMap, attach with
anim_setup.gd:share_library(P5). Gate: 0 unresolved tracks, identical track layout. -
Speeds.
foot_speedper cycle and per body (P9). Gate: controller and BlendSpace speeds within 2 percent. -
Tree. Build in code (
anim_tree.gd, P6): BlendTree root, StateMachine inside, BlendSpace1D with sync, OneShot with a filter, TimeScale. Gate:drivewith scripted input gives the expected state list and times; tree audit clean. The transition helper that passed the drive test:static func transition(expr: String, at_end: bool, xfade: float) -> AnimationNodeStateMachineTransition: var t := AnimationNodeStateMachineTransition.new() t.xfade_time = xfade t.advance_mode = AnimationNodeStateMachineTransition.ADVANCE_MODE_AUTO # default Enabled never auto-fires if at_end: t.switch_mode = AnimationNodeStateMachineTransition.SWITCH_MODE_AT_END if expr != "": t.advance_expression = expr # read on tree.advance_expression_base_node return t # sm.add_transition(&"Ground", &"Fall", transition("not on_floor and not jump_pressed", false, 0.2))Drive it from gameplay with
tree.set("parameters/sm/Ground/blend_position", speed)and the state node's properties; fire actions withtree.set("parameters/act/request", AnimationNodeOneShot.ONE_SHOT_REQUEST_FIRE). -
Layers and IK. OneShot filters (P7), FootPlacer plus TwoBoneIK3D (P10). Gate: foot within 2 cm of the target on a step, a hole and a 15 deg slope, read in
skeleton_updated. Modifiers run in child order, so the placer (targets and hips) goes before the solver:var ik := TwoBoneIK3D.new() skeleton.add_child(ik) # after FootPlacer ik.setting_count = 2 for i in 2: var side: String = ["Left", "Right"][i] # := cannot infer from an array index ik.set_root_bone_name(i, side + "UpperLeg") ik.set_middle_bone_name(i, side + "LowerLeg") ik.set_end_bone_name(i, side + "Foot") ik.set_target_node(i, ik.get_path_to(targets[i])) ik.set_pole_node(i, ik.get_path_to(knee_poles[i])) # 0.6 m in front of the knee ik.set_pole_direction(i, SkeletonModifier3D.SECONDARY_DIRECTION_PLUS_Z) skeleton.skeleton_updated.connect(_check_feet) # final pose, after every modifier and influenceLower
influencewhile running and set it to 0 in the air, so authored motion shows through (Lukky, MbaPDWfbNLo 00:09:30). -
Camera and cutscene. SpringArm3D with a sphere shape (P12); one AnimationPlayer timeline (P13). Gate: call order and times, camera at checkpoints,
animation_finished, section playback. -
Look. Pose sheets: T-pose front and side, 8 walk phases, each state, IK terrain, cutscene timeline (P14). Gate: every sheet opened and described.
Expert checklist (state these in the plan)
- Modifier output is rolled back every frame (Fair Fight XFZQNsFejwk 00:02:04; P10 reads the
animated pose a frame later). Fine for post effects; when modifiers own the pose, put
pose_persist.gdwith role RESTORE first and SNAPSHOT last: an incremental 5 deg modifier then reached 60 deg in 12 frames instead of staying at 5 (P16). RESTORE overrides the animation, so never use it on top of a playing clip. - IK solves position only. TwoBoneIK3D left the foot 12.1 deg off a 15 deg slope; a
CopyTransformModifier3Dafter it (rotation only, reference type Node, an align node with the ground tilt) brought it to 0.0 deg without moving the foot (P16; Lukky MbaPDWfbNLo 00:07:49). - Deterministic IK solves from scratch each frame; a one-iteration chain needs the angle limit
at the full 180 deg (Lukky 00:04:46).
deterministicdefaults to false on IterateIK3D; turn it on for stepping legs (MeroDev 17xi4vDqQJk 00:02:28). - Bezier and property tracks cannot blend (docs): the tree blends value, position, rotation and scale tracks.
- Call Method tracks do not run in the editor preview (docs): test them in a run (P13).
- Capture update mode blends from the current value to the first key: a property at 5 with a key
10 at 0.5 s read 7.5 at 0.25 s under
play_with_capture(P16). - Cache
find_trackin a path-to-index map when scripts sample many tracks: Fair Fight measured 1.5 to 3x on large rigs (XFZQNsFejwk 00:04:03 to 00:06:45); on the 22-track test rig in GDScript, 1.2x (P16). It needs one track layout across clips, so turn offanimation/remove_immutable_tracks. - Gate one-shots on
animation_finishedplus a flag, or the next frame's locomotion call replaces the hit clip (DevWorm GMyw3eHDw7s 00:22:58). Measured: "hurt" held for its 0.4 s, then walk resumed (P16). - Blender source. Rigify Limb Segments 1 and Game Friendly single root before export (CoderNunk
0wMONEpEXpQ 00:00:19, 00:01:23).
nodes/apply_root_scale(default true) bakes import scale into meshes and clips, root stays at 1 (docs). - BlendSpace2D for 4-way sprites: points at plus or minus 1, axis range plus or minus 1.1 so diagonals snap to left and right; 2D up is negative Y (Chris WrMORzl3g1U 00:09:20, 00:13:09).
Numbers
| What | Value | Source |
| ---------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------- |
| Human walk, run ground speed | about 1.2 to 1.5 m/s walk, 3 to 4 m/s jog [added] | measure the clip instead (P9) |
| No-slide speed measured | walk 1.200, run 3.504 m/s on clips built for 1.2 and 3.5 | P9 |
| Foot-slide tolerance | planted foot under 0.1 m/s; speeds within 2 percent [added] | baseline G5, P9 |
| Locomotion crossfade | 0.1 to 0.2 s; landing 0.05 s; Land to Ground at end with 0.15 s | P6 |
| Import FPS | 30 (default animation/fps) | importer |
| motion_scale after Normalize Position Tracks | source hip height (0.97 m test rig) | P4 |
| IK foot error | under 2 cm required, under 0.1 mm measured | P10 |
| FootPlacer ray | 0.5 m above to 1.0 m below the animated foot; hips drop clamp 0.35 m | P10 |
| Spring arm | sphere r 0.2 stops 0.2 m plus margin 0.01 m short of a wall | P12 |
| IterateIK3D defaults | max_iterations 4, min_distance 0.001, angular_delta_limit 2 deg, deterministic false | class reference |
| Tween stagger | 0.05 s per item, 0.2 s per tween | P11; aagPe4dvM2M 00:04:04 |
| Modifier cost
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ai-job-search
73.0kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.5kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
