# configure-animation

Covers setting up, blending and retargeting GLB animation clips in PlayCanvas, and fixing T pose or frozen playback.

Skill by PlayCanvas. Category: Design and frontend.

## Install

Project (for this project only):

```sh
npx skills add playcanvas/skills --skill configure-animation
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add playcanvas/skills --skill configure-animation -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 228. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/playcanvas/skills/configure-animation)

## Source

[Open the source](https://github.com/playcanvas/skills/tree/HEAD/skills/configure-animation). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: configure-animation
description: Use before playing, blending, or retargeting GLB animation clips in PlayCanvas, or when diagnosing T-pose, frozen playback, or binding failures.
---

# Animation setup

Get clip and joint names from `inspect-glb`; never guess them.

- For one clip, use the surface's simple playback path. For blending, transitions, or events, adapt
  an `AnimStateGraph` from an official animation example with `find-examples`.
- Put the `anim` component on or above the rendered skinned hierarchy, not on a separate pivot.
- Clamp every 1D blend parameter to its first and last child points. The Engine does not; values
  outside the span zero every weight and can make synced speeds non-finite, freezing the pose.
- Retarget only when each source `animationTargets` path, minus its `.translation`, `.rotation`,
  `.scale`, or `.weights` suffix, matches a destination `nodePaths` entry below the model root.
  Equal joint counts or similar names are not enough.
- Scale a wrapper, never skinned bones.

## Prove playback

An active state or advancing state time does not prove motion. Sample two non-root joints over
several rendered frames (`inspect-runtime`) at idle and at both ends of each blend tree. Zero joint motion means a
binding, playback, or blend-weight failure.

## Diagnose

- T-pose: no clip assigned, target paths differ, or the anim component sits outside the rendered
  hierarchy.
- Frozen pose: an unclamped blend input or a non-finite speed.
- Partial or exploded motion: incompatible rigs.

Read only the reference matching the code: [direct Engine](references/direct-engine.md),
[React](references/react.md), or [Web Components](references/web-components.md).
````

- Previous: [build-app](https://syn4pse.dev/terminal/playcanvas-build-app.md)
- Next: [calibrate-model](https://syn4pse.dev/terminal/playcanvas-calibrate-model.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
