naturalistic-motion — Claude Code skill: what it does, how to install
Animation guidelines for organic creatures and natural elements. Guides agents to create continuous subtle motion instead of robotic stiffness.
npx skills add dylantarre/animation-principles --skill naturalistic-motion -a claude-codeWhat naturalistic-motion does
This skill directs your coding agent to approach movement from a biological perspective. Living organisms never freeze into absolute stillness. The guide adapts classic animation principles for organic subjects, prioritizing arcs over straight lines, staggered timing, and continuous deceleration. It recommends exaggerating organic traits by 10-20% beyond reality to keep them readable.
The rules focus on telltale signs of life: breathing cycles and subtle weight shifts. It flags common synthetic errors like twinning and mirrored poses. Real creature video reference is mandatory here, because guessing biological mechanics without real-world footage leads to stiff results.
What it helps with
- bring life to static creature idle poses
- eliminate twinning and mirrored limb movement
- layer overlapping action through joints and soft tissue
- clean up noisy secondary motion without losing organic feel
Example prompts for the agent
- Build an idle animation for a resting dog with breathing cycles and subtle weight shifts
- Review this creature locomotion cycle to eliminate mirrored limb timing
- Adjust the tail movement to follow natural arcs and soft-body overlapping
How to install naturalistic-motion
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill naturalistic-motion -a claude-code2Manually: put the files in place
~/.claude/skills/naturalistic-motion/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/naturalistic-motion/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill naturalistic-motion -a codex2Manually: put the files in place
.agents/skills/naturalistic-motion/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill naturalistic-motion -a cursor2Manually: put the files in place
.cursor/skills/naturalistic-motion/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dylantarre/animation-principles naturalistic-motion2Manually: put the files in place
.github/skills/naturalistic-motion/SKILL.md1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill naturalistic-motion -a gemini-cli2Platform CLI
gemini skills install https://github.com/dylantarre/animation-principles --path skills/02-by-thinking-style/naturalistic-motionManually: put the files in place
.devin/skills/naturalistic-motion/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill naturalistic-motion -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 naturalistic-motion
How do I install naturalistic-motion in Claude Code?
Run npx skills add dylantarre/animation-principles --skill naturalistic-motion -a claude-code. The file will be written to ~/.claude/skills/naturalistic-motion/SKILL.md.
What does naturalistic-motion do?
It provides prompt guidelines that teach AI agents how living tissue, creatures, and characters behave. The focus is on weight shifts, continuous breathing, and curved trajectories.
How does the skill fix cluttered animation?
It instructs the agent to strip away extra secondary layers, clarify the primary intent, slow down the action, and set a clear pose hierarchy.
Source text
SKILL.md · MIT
--- name: naturalistic-motion description: Use when animation should feel organic and lifelike—creature animation, realistic characters, nature elements, or any motion that needs to breathe with authentic living quality. --- # Naturalistic Motion Think like a biologist watching life unfold. Nothing in nature moves mechanically. Everything breathes, adjusts, responds. Life is continuous subtle motion. ## Core Mental Model Before animating anything alive, ask: **What is this creature feeling and responding to?** Living things are never truly still. They shift weight, breathe, notice, adjust. Naturalistic motion isn't about copying reality—it's about capturing aliveness. ## The 12 Principles Through Organic Life **Secondary Action** — Life is layered motion. While a character talks, they breathe. While they breathe, they blink. While they blink, their weight shifts. Stack subtle actions. **Follow Through & Overlapping Action** — Bodies are systems of connected parts. Movement cascades through joints and soft tissue. Nothing moves in isolation. **Arcs** — Nature abhors straight lines. Every joint creates rotation. Every movement traces curves. Study the path of a hand gesture—it's never linear. **Slow In & Slow Out** — Organic motion accelerates and decelerates continuously. Muscles engage and release. This is what makes movement look "alive" rather than robotic. **Timing** — Life has varied timing. Quick glances, slow stretches, medium walks. The diversity of speeds creates believable organism behavior. **Squash & Stretch** — Flesh is malleable. Skin wrinkles, muscles bulge, fat jiggles. Even subtle squash and stretch sells organic tissue. **Anticipation** — Living things telegraph intention. Watch a cat before it pounces. The body organizes itself before action. Include preparatory micro-movements. **Solid Drawing** — Anatomy matters. Understand skeletal structure, muscle groups, and how they connect. Organic motion respects physical construction. **Appeal** — Naturalistic doesn't mean realistic. Appealing organic motion is idealized life—the essence of a cat, not a veterinary diagram. **Exaggeration** — Subtle exaggeration. Naturalistic motion pushes organic qualities just 10-20% past reality. Enough to read clearly, not enough to break believability. **Staging** — Let organic motion read. Don't let naturalistic complexity become visual noise. Clarity serves believability. **Straight Ahead & Pose to Pose** — Organic motion often benefits from straight ahead animation for its emergent quality. Let movement discover itself. ## Practical Application **Signs of Life:** - Breathing: Constant subtle chest/belly movement - Weight shifts: Never perfectly balanced - Micro-saccades: Eyes are never frozen - Postural adjustments: Comfort-seeking behavior - Environmental awareness: Reactions to sound, light, temperature **Common Naturalistic Mistakes:** - Twinning: Both arms doing exactly the same thing (never happens in nature) - Perfect symmetry: Living poses are asymmetrical - IK lock: Limbs shouldn't feel pinned to points in space - Mechanical timing: Uniform speed reads as robotic When motion feels "dead": 1. Add breathing rhythm 2. Introduce subtle weight shifts 3. Offset timing between left/right 4. Include environmental micro-reactions When motion feels "noisy": 1. Reduce secondary motion layers 2. Clarify the primary intention 3. Slow down and simplify 4. Establish clearer pose hierarchies **Reference is Essential:** - Study video reference of real creatures - Film yourself performing the action - Watch slow-motion footage to understand mechanics - Observe animals at rest, not just in action ## The Golden Rule **Living things are always doing something, even when doing nothing.** The baseline state of life is gentle motion. Stillness in animation equals death. Let your creatures breathe.
© dylantarre · MIT · dylantarre/animation-principles