motion-designer — Claude Code skill: animation by 12 principles
A skill that turns your coding agent into a motion designer: timing specs, easing curves and handoff notes for UI animation.
npx skills add dylantarre/animation-principles --skill motion-designer -a claude-codeWhat motion-designer does
This skill gives the agent a motion design vocabulary. It walks through Disney's 12 animation principles and maps them onto interfaces: squash and stretch for elements with personality, anticipation before a navigation launch, follow through for details that lag behind. Each principle comes with a concrete example — a button recoiling before a transition, a shadow breathing while a card opens.
What's inside is method, not code. The agent helps you draft a motion style guide with easing curves, write timing specifications for developer handoff, and describe reference animations. Reduced motion alternatives get their own section, so the agent won't hand you a single version and call it done.
The skill is worth reaching for when animation has to be explained in words and numbers, not just shown. It advises starting with one clear idea per scene instead of stacking several. Install is a single npx skills add command; the repository is open and MIT-licensed.
What it helps with
- write timing specs a developer can follow without a mockup
- pick easing curves that match the brand's character
- break a complex motion into anticipation, action and follow through
- assemble a motion style guide for the team
- propose a reduced motion alternative for an animation
Example prompts for the agent
- help me design the animation for opening a side panel, I need timings and easing
- break down this card motion by principle: where is anticipation, where is follow through
- draft a motion style guide for our interface with curves and timings
How to install motion-designer
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill motion-designer -a claude-code2Manually: put the files in place
~/.claude/skills/motion-designer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/motion-designer/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill motion-designer -a codex2Manually: put the files in place
.agents/skills/motion-designer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill motion-designer -a cursor2Manually: put the files in place
.cursor/skills/motion-designer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dylantarre/animation-principles motion-designer2Manually: put the files in place
.github/skills/motion-designer/SKILL.md1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill motion-designer -a gemini-cli2Platform CLI
gemini skills install https://github.com/dylantarre/animation-principles --path skills/03-by-role-persona/motion-designerManually: put the files in place
.devin/skills/motion-designer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill motion-designer -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 motion-designer
How do I install motion-designer in Claude?
Run npx skills add dylantarre/animation-principles --skill motion-designer -a claude-code. The skill lands at ~/.claude/skills/motion-designer/SKILL.md.
What does motion-designer do?
It helps the agent design interface motion: breaking animation down by the 12 principles, suggesting timings and easing curves, and preparing specs for developer handoff.
Which platforms does the skill support?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each platform has its own install command and its own skills directory.
Source text
SKILL.md · MIT
--- name: motion-designer description: Use when designing visual motion systems, creating animation specifications, or when a designer needs guidance on crafting beautiful, meaningful movement. --- # Motion Designer: Visual Animation Craft You are a motion designer creating expressive, purposeful movement. Apply Disney's 12 principles to craft animations that communicate and delight. ## The 12 Principles for Motion Design ### 1. Squash and Stretch The soul of organic movement. Compress on impact, elongate during speed. Preserve volume—wider means shorter. Use for characters, UI elements with personality, brand mascots. ### 2. Anticipation Wind-up before action. A button recoils before launching navigation. A drawer shrinks before expanding. Anticipation builds expectation and makes actions feel intentional. ### 3. Staging Composition through motion. Use scale, position, focus, and timing to direct the viewer's eye. Clear the stage before introducing new elements. One clear idea per scene. ### 4. Straight Ahead vs Pose to Pose Straight ahead: Draw frame-by-frame for fluid, unpredictable motion. Ideal for fire, water, organic effects. Pose to pose: Key positions first, then in-betweens. Precise control for choreographed sequences. ### 5. Follow Through and Overlapping Action Nothing stops at once. Hair trails the head, fabric follows the body. Stagger element arrivals—faster elements lead, heavier ones lag. Creates rhythm and naturalism. ### 6. Slow In and Slow Out Ease into and out of poses. More frames near keyframes, fewer in motion. Bezier curves control this feel. Sharp curves = snappy. Gentle curves = graceful. ### 7. Arc Living things move in curves. Avoid robotic linear paths. Pendulum swings, hand gestures, eye movements—all arcs. Even UI elements feel more natural on curved paths. ### 8. Secondary Action Supporting movements that reinforce the primary action. While a character walks (primary), their coat sways (secondary). While a card opens, a shadow breathes. Adds depth without distraction. ### 9. Timing The heartbeat of animation. Fast timing = light, agile, comedic. Slow timing = heavy, dramatic, weighted. Vary timing for contrast. Consistent timing creates rhythm. ### 10. Exaggeration Push beyond reality for clarity and impact. Subtle exaggeration for UI: 110% scale. Bold exaggeration for character: stretched limbs, squashed faces. Match exaggeration to brand voice. ### 11. Solid Drawing Understand form, weight, and volume. Even 2D motion should feel three-dimensional. Maintain consistent perspective. Avoid "twins"—asymmetry adds life. ### 12. Appeal The charisma of design. Clear shapes, balanced proportions, appealing movement quality. Not just "pretty"—captivating. The viewer should want to keep watching. ## Design Deliverables - Motion style guides with easing curves - Timing specifications for developer handoff - Reference animations in After Effects or Principle - Reduced motion alternatives
© dylantarre · MIT · dylantarre/animation-principles