Motion Design
LottieFilesOfficialCreated by LottieFiles
- Skill
- Guidelines
- Design and creative
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a structured approach to motion design, focusing on timing, easing, choreography, and Disney animation principles adapted for user interfaces. It guides users through defining motion personality, selecting appropriate properties, and applying specific patterns for various UI states. The framework emphasizes emotional intent, visual narrative, and motion craft to ensure animations are technically sound and consistent across projects.
What it does
- Defines motion personality archetypes like Playful, Premium, Corporate, and Energetic.
- Provides duration and easing tables for various UI elements and interaction types.
- Outlines choreography rules including the 1/3 rule for distance and element staging.
- Maps emotional goals to specific motion paths, easing curves, and durations.
- Offers a checklist for evaluating animations based on primary, secondary, and ambient layers.
- Provides specific patterns for common interactions like button presses, card entrances, and error states.
When to use it
- When designing UI animations such as buttons, modals, and page transitions.
- When creating micro-interactions or feedback states for user actions.
- When establishing a consistent brand motion identity.
- When planning complex multi-element sequences or scroll-triggered effects.
- When troubleshooting animations that feel robotic, flat, or distracting.
Advantages
- Ensures consistent motion behavior across an application.
- Provides clear, data-backed guidelines for timing and easing.
- Helps align animation style with desired emotional impact.
- Offers a systematic approach to choreography and multi-element staging.
- Includes a troubleshooting guide to identify and fix common animation issues.
Usage examples
- “Help me define a motion personality for a professional financial dashboard.”
- The agent will recommend the 'Corporate' archetype, suggesting a duration of 200-400ms, specific cubic-bezier easing, and minimal overshoot to maintain a clean, professional feel.
- “What are the best practices for a card entrance animation?”
- The agent will provide a step-by-step recipe including starting position, easing curves, follow-through timing, and secondary content fade-in sequences.
- “My button press animation feels robotic. How can I improve it?”
- The agent will analyze the current implementation against the 'Button Press' pattern, suggesting the addition of anticipation, squash, and follow-through phases with appropriate easing.
- “How should I choreograph a list of items appearing on screen?”
- The agent will suggest a micro-cascade stagger pattern with a specific delay budget to ensure the total animation remains under 500ms.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/lottiefiles/motion-design/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip motion-design.zip -d .agents/skills
Documentation by LottieFiles
Motion Design Skill
When to Apply
Use this skill when:
Creating UI animations (buttons, cards, modals, page transitions)
Designing micro-interactions and feedback animations
Building loading, success, or error states
Animating illustrations or decorative elements
Planning scroll-triggered or progress-based animations
Establishing brand motion identity
Choreographing multi-element sequences
Decision tree:
Does it serve a functional purpose (feedback, guidance)? → Timing rules for responsiveness
Does it express brand personality? → Motion Personality archetypes
Does it tell a story or guide attention? → Disney principles + choreography
Is this a complex multi-element scene? → 1/3 Rule + stagger patterns
Quick Reference: 8-Step Checklist
Before creating any animation:
Emotional target? — joy, calm, urgency, elegance
Motion Personality? — Playful, Premium, Corporate, Energetic
Primary property? — position, scale, rotation, opacity
Duration? — see duration table below
Easing family? — entrance=decelerate, exit=accelerate
Hero element? — apply staging principles
Secondary + ambient layers? — add richness
1/3 rules? — motion distance, simultaneous elements
Three Pillars (CRITICAL)
Every animation must satisfy three pillars before any technical decisions:
| Pillar | Question | Drives |
|---|---|---|
| Emotional Intent | What should the viewer FEEL? | Easing, timing, amplitude |
| Visual Narrative | What's the micro-story? | Setup → Action → Resolution |
| Motion Craft | How do we make it believable? | Physics, secondary motion, paths |
Three motion layers (flat animation = missing layers):
Primary: Main action the viewer follows
Secondary: Supporting richness (shadows, icons shifting)
Ambient: Background life (gradients, subtle pulses)
Deep dive: director/core-philosophy.md
Motion Personality
Select ONE archetype per project. Apply consistently.
| Archetype | Duration | Easing | Overshoot | Keywords |
|---|---|---|---|---|
| Playful | 150-300ms | ease-out-back | 10-20% | fun, whimsical, bouncy, cute |
| Premium | 350-600ms | cubic-bezier(0.4,0,0.2,1) | 0% | elegant, minimal, luxury, sophisticated |
| Corporate | 200-400ms | cubic-bezier(0.2,0,0,1) | 0-3% | clean, professional, business, dashboard |
| Energetic | 100-250ms | ease-out-expo | 15-30% | dynamic, energetic, bold, exciting |
Default: Corporate for UI, Playful for illustrations.
Brand Motion Identity — define three constants:
Signature easing: One curve for 80% of animations
Duration palette: 3 durations (quick / standard / slow)
Entrance pattern: One consistent entry style
Deep dive: director/motion-personality.md
Property Selection
| Effect Goal | Primary Property | Secondary Properties |
|---|---|---|
| Entrance/Exit | position | opacity, scale |
| Emphasis/Attention | scale | rotation (subtle), opacity pulse |
| State Change | opacity, color | scale (press feedback) |
| Direction/Flow | position | rotation (follow path) |
| Depth/3D Feel | scale + shadow | position (parallax) |
| Loading/Progress | rotation (spinner) | scale, opacity pulse |
| Success | scale (pop) | color, rotation (checkmark draw) |
| Error/Alert | position (shake) | color, rotation (wobble) |
Simplicity threshold: Use the minimum properties needed. One = direct. Two = polished. Three+ = potentially overwhelming.
Deep dive: reference/property-selection.md
Duration Table
| Element Type | Duration | Rationale |
|---|---|---|
| Tooltip / micro-feedback | 80-120ms | Must feel instant |
| Button press / toggle | 120-180ms | Responsive feedback |
| Icon transition | 150-250ms | Clear state change |
| Card enter / exit | 200-350ms | Spatial awareness |
| Modal / dialog | 300-400ms | Focus shift |
| Page transition | 400-600ms | Context switch |
| Dramatic reveal | 600-1200ms | Theatrical build |
Distance scales duration: 100px = base. 200px = 1.3x. 400px = 1.6x.
Enter > Exit: Entrances 30-50% longer than exits. Users care about what appears.
Interactive feedback:
Hover: <100ms
Press: <150ms
Release/settle: 200-300ms
Error shake: 300-400ms (2-3 oscillations)
Deep dive: reference/timing-easing-tables.md
Easing Selection
Directional rules:
Entrance → decelerate (fast start, gentle landing): ease-out family
Exit → accelerate (gentle start, fast departure): ease-in family
On-screen → smooth both ends: ease-in-out family
Looping ambient → seamless: sine-based ease-in-out
Industry standards:
| Standard | Cubic Bezier | Use For |
|---|---|---|
| Material Design 3 | (0.2, 0, 0, 1) | Default on-screen |
| MD3 Emphasized | (0.05, 0.7, 0.1, 1) | Entrances, attention |
| MD3 Accelerate | (0.3, 0, 1, 1) | Exits, dismissals |
| Apple HIG | (0.25, 0.1, 0.25, 1) | Standard iOS |
| Snappy UI | (0.2, 0, 0, 1) | Fast, decisive |
| Gentle float | (0.4, 0, 0.2, 1) | Ambient, background |
| Bounce settle | (0.175, 0.885, 0.32, 1.275) | Overshoot, playful |
Material-based easing:
| Material | Duration Scale | Overshoot |
|---|---|---|
| Rigid (metal, stone) | 1.2x | 0% |
| Elastic (rubber, gel) | 0.8x | 15-25% |
| Fluid (water, paint) | 1.5x | 5% |
| Paper (cards, sheets) | 1.0x | 3-5% |
| Gas (smoke, fog) | 2.0x | 0% |
| Glass (brittle) | 0.9x | 0% |
Deep dive: reference/timing-easing-tables.md
Common Patterns
Button Press (Playful)
Anticipation: Scale to 0.97 (50ms, ease-out)
Squash: Scale to [1.04, 0.96] (100ms, ease-in)
Follow through: Overshoots to 1.02, settles to 1.0 (spring, 200ms)
Secondary: Shadow shrinks during press, icon shifts down 2px
Total: ~150ms press + 200ms settle
Card Entrance (Premium)
Start: 20px below target, opacity 0
Path: Slight curve (10px X offset at midpoint)
Easing: ease-out-cubic deceleration
Follow through: Shadow arrives 50ms after card
Secondary: Content fades in 100ms after card lands
Staging: Other cards dim to 80%
Success State (Playful)
Primary: Scale pop with ease-out-back
Secondary: Checkmark draws in
Ambient: Subtle particle burst
Color: Green fill
Total: 300-400ms
Error Shake (Corporate)
Primary: Position oscillates 2-3 times, ±10-15px horizontal
Easing: ease-in-out for sharp stops
Color: Red tint
Total: 300-400ms
No overshoot: Errors feel firm
More patterns: patterns/entrance-exit.md | patterns/state-feedback.md
Choreography Essentials
Coordinated entry:
Lead with the hero — primary element enters first or most prominently
Spatial consistency — all elements enter from same direction
Counter-motion — hero moves right → ambient moves left at 20-30% speed
1/3 Rule (distance): No motion travels more than 1/3 of screen without a keyframe change.
1/3 Rule (elements): With 3+ elements, no more than 1/3 in active motion simultaneously.
Stagger budgets:
| Pattern | Delay | Total Budget | Use Case |
|---|---|---|---|
| Micro cascade | 20-40ms | <200ms | List items, grid cells |
| Standard | 50-100ms | <400ms | Cards, panels, nav |
| Dramatic | 100-200ms | <600ms | Hero sections |
| Wave | 30-60ms | <500ms | Data visualizations |
Critical: Total stagger must stay under 500ms.
Deep dive: director/choreography.md
Emotion-to-Motion Map
| Emotion | Character | Path | Easing | Duration |
|---|---|---|---|---|
| Joy | Bouncy, arcs | Curved, upward | ease-out-back | 200-400ms |
| Calm | Smooth, flowing | Gentle curves | sine ease-in-out | 500-1000ms |
| Urgency | Sharp, fast | Straight lines | ease-out | 100-200ms |
| Sadness | Slow, downward | Drooping curves | cubic ease-in-out | 600-1200ms |
| Surprise | Sudden, expanding | Radial outward | ease-out-expo | 150-300ms |
| Elegance | Slow, controlled | Long arcs | (0.4,0,0.2,1) | 400-700ms |
| Playfulness | Bouncy, irregular | Arcs, squiggly | ease-out-back | 200-350ms |
Path as language: Angular = tense. Curved = friendly. Spiral = whimsical. Diagonal = purposeful. Vertical = growth/weight. Horizontal = progress.
Deep dive: director/emotion-mapping.md
Weight Classification
| Weight | Examples | Duration | Overshoot | Easing |
|---|---|---|---|---|
| Heavy | Modals, overlays | 300-500ms | 0% | Gentle, high damping |
| Medium | Cards, panels | 200-350ms | 3-5% | Moderate |
| Light | Tooltips, badges, icons | 80-200ms | 5-15% | Responsive |
Quality Rules
CRITICAL — never break
Never linear for spatial movement — always use easing curves (linear only for spinners, progress bars)
Never opacity-only for important state changes — combine with position or scale
Never exceed 1/3 screen without intermediate keyframe
Always three motion layers — primary + secondary + ambient
HIGH — strongly follow
Match duration to element type (see tables)
Use directional easing (ease-out entrance, ease-in exit)
Apply Disney principles (especially anticipation, follow-through)
Maintain consistent personality across scene
Full checklist: reference/quality-checklist.md
Troubleshooting Quick Reference
| Problem | Likely Cause | Fix |
|---|---|---|
| Looks robotic | Linear easing or no arcs | Add easing curves + arc paths |
| Feels too slow | Duration too long for element type | Check duration table, use ease-out |
| Feels cheap/flat | Missing secondary + ambient | Add shadow motion + background life |
| Too distracting | Too many elements moving | Apply 1/3 rule, reduce amplitude |
| No personality | Generic easing everywhere | Apply personality archetype consistently |
Deep dive: reference/troubleshooting.md
File Reference
Philosophy (director/):
core-philosophy.md — Three Pillars deep dive
decision-framework.md — Full decision pipeline
disney-principles.md — 12 principles, UI-adapted
motion-personality.md — 4 archetypes + brand identity
emotion-mapping.md — Emotion → motion + color psychology
choreography.md — Multi-element coordination
narrative-structure.md — Micro-story framework
context-adaptation.md — Platform, a11y, performance
Reference (reference/):
timing-easing-tables.md — Duration + easing lookups
property-selection.md — Property communication guide
troubleshooting.md — Animation smells + fixes
quality-checklist.md — Evaluation criteria
Patterns (patterns/):
entrance-exit.md — Entrance/exit recipes
state-feedback.md — Success, error, loading, hover
ambient-continuous.md — Looping, breathing, parallax
multi-element.md — Stagger + choreography recipes
Files
- ATTRIBUTION.mdAdded by AutoGineer920 B
- LICENSELicence file added by AutoGineer1.0 KiB
- SKILL.md12.3 KiB
- director/choreography.md3.0 KiB
- director/context-adaptation.md3.0 KiB
- director/core-philosophy.md1.8 KiB
- director/decision-framework.md2.8 KiB
- director/disney-principles.md3.1 KiB
- director/emotion-mapping.md2.8 KiB
- director/motion-personality.md2.9 KiB
- director/narrative-structure.md2.4 KiB
- patterns/ambient-continuous.md2.8 KiB
- patterns/entrance-exit.md2.8 KiB
- patterns/multi-element.md2.3 KiB
- patterns/state-feedback.md3.0 KiB
- reference/property-selection.md2.9 KiB
- reference/quality-checklist.md2.0 KiB
- reference/timing-easing-tables.md2.8 KiB
- reference/troubleshooting.md2.6 KiB
director/core-philosophy.md
Core Philosophy
Three Pillars
Pillar 1: Emotional Intent
Define target emotion before choosing any property.
| Emotion | Character | Timing | Easing |
|---|---|---|---|
| Trust | Smooth, predictable | 300-400ms | Gentle curves |
| Delight | Bouncy, surprising | 200-300ms | Overshoot |
| Urgency | Sharp, direct | 100-200ms | Snappy ease-out |
| Calm | Slow, flowing | 500-1000ms | Sine curves |
| Surprise | Sudden, explosive | 150-300ms | Exponential |
| Confidence | Direct, decisive | 200-400ms | Strong ease-out |
Pillar 2: Visual Narrative
| Phase | Duration Share | Purpose |
|---|---|---|
| Setup | 20-30% | Establish context, prepare viewer |
| Action | 30-40% | Primary motion, hero moment |
| Resolution | 30-40% | Settle, breathe, confirm |
Even a 200ms tooltip fade has implicit setup→action→resolution.
Pillar 3: Motion Craft
Easing curves match emotional intent
Duration proportional to element size and distance
Arcs for organic, straight for mechanical
Secondary motion (shadows, related elements)
Nothing starts and stops all at once
Three Motion Layers
| Layer | Role | Amplitude |
|---|---|---|
| Primary | Main action viewer follows | 100% |
| Secondary | Supporting richness | 30-50% |
| Ambient | Background life | 10-20% |
Secondary offset 50-100ms from primary, different easing
Ambient is continuous/slow, never demands attention
Primary-only animation feels flat; always add secondary + ambient
The 1/3 Screen Rule
No motion travels >1/3 screen without intermediate keyframe. Break with direction changes, speed shifts, or arc adjustments.
The Attention Budget
One hero motion per scene moment
Max 2-3 elements in active motion simultaneously
Ambient doesn't count against budget
Stagger rather than synchronize
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- LottieFiles
- Publisher
- LottieFiles (Official)
- Source
- LottieFiles/motion-design-skill · skills/motion-design · commit f9a8a04
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by LottieFiles or LottieFiles.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download motion-design.zip