marselo-4/TotAuto / .claude/skills/r3f-animation
r3f-animation
VerifiedAnimate React Three Fiber objects with useFrame, damping, and GLTF clips. Use for procedural motion, animation transitions, or demand-loop animation; use physics guidance for collision-driven movement.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
| references/clips.md | markdown | 2.2 KB |
references/clips.md
View on GitHub# Independent GLTF clip playback
Use when animating an authored asset. Mount below Suspense inside Canvas, provide the asset, and choose a clip name that actually exists. The cloned root owns its pose; geometry/materials remain shared.
```tsx
import { useEffect, useMemo } from 'react'
import { useAnimations, useGLTF } from '@react-three/drei'
import { clone } from 'three/addons/utils/SkeletonUtils.js'
export default function AnimatedModel({ url = '/models/robot.glb', clip = 'Idle' }) {
const { scene, animations } = useGLTF(url)
const root = useMemo(() => clone(scene), [scene])
const { actions } = useAnimations(animations, root)
useEffect(() => {
const action = actions[clip]
if (!action) return
action.reset().play()
return () => { action.stop() }
}, [actions, clip])
return <primitive object={root} />
}
```
- Inspect available animation names; don't silently claim an absent clip is playing. The caller can choose the clip or present available choices.
- `useAnimations` advances its mixer. Do not also call `mixer.update(delta)` for that mixer.
- Separate mixers/actions per cloned root allow independent playback. Clips can be shared; reusing the same skeleton pose/root cannot produce independent motion.
- For crossfades, reset/play the incoming action, enable it, and fade the outgoing action while the mixer keeps ticking. An immediate `stop()` defeats the outgoing fade; delayed cleanup must be canceled on rapid transitions.
- For one-shot clips, configure LoopOnce/clamping deliberately. Cleanup must remain safe when React Strict Mode replays effects.
- On a demand loop, keep invalidating while actions actually advance; an AnimationMixer does not independently start a Canvas loop. Stop requesting frames for paused/finished actions.
- Do not dispose cached geometry/materials when removing a clone. If cloning introduces owned skeleton GPU resources, release those after their last use; resource ownership is distinct from stopping playback.
Sources: [Drei useAnimations](https://drei.docs.pmnd.rs/abstractions/use-animations), [AnimationAction](https://threejs.org/docs/#AnimationAction), [SkeletonUtils](https://threejs.org/docs/#SkeletonUtils).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |