[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M753DCXDW72EYW5HWTY236CJ":3,"skill-same:01M753DCXDW72EYW5HWTY236CJ":121},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":34,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M753DCXDW72EYW5HWTY236CJ","motion-design",null,"Applies motion design principles to create emotionally-driven, technically sound animations and transitions. Provides timing, easing, choreography, and Disney animation principles adapted for UI. Use when creating animations, transitions, micro-interactions, loading states, page transitions, scroll-triggered effects, or any motion work. Works with CSS, Framer Motion, GSAP, Lottie, Spring, or any animation system.","igun997\u002Fpi-orchestrator","igun997","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12785984?v=4","01M753CHKN0S0QQBWWV2ME6GNC","Indra Gunanda","01M753CHM8W5EWGZ7MN3PCN65E",2,"MIT","https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: motion-design\ndescription: >\n  Applies motion design principles to create emotionally-driven, technically sound animations and transitions.\n  Provides timing, easing, choreography, and Disney animation principles adapted for UI.\n  Use when creating animations, transitions, micro-interactions, loading states, page transitions,\n  scroll-triggered effects, or any motion work. Works with CSS, Framer Motion, GSAP, Lottie, Spring,\n  or any animation system.\nlicense: MIT\nmetadata:\n  author: LottieFiles\n  version: \"1.0.0\"\n---\n\n# Motion Design Skill\n\n## When to Apply\n\nUse this skill when:\n- Creating UI animations (buttons, cards, modals, page transitions)\n- Designing micro-interactions and feedback animations\n- Building loading, success, or error states\n- Animating illustrations or decorative elements\n- Planning scroll-triggered or progress-based animations\n- Establishing brand motion identity\n- Choreographing multi-element sequences\n\n**Decision tree:**\n1. Does it serve a functional purpose (feedback, guidance)? → Timing rules for responsiveness\n2. Does it express brand personality? → Motion Personality archetypes\n3. Does it tell a story or guide attention? → Disney principles + choreography\n4. Is this a complex multi-element scene? → 1\u002F3 Rule + stagger patterns\n\n---\n\n## Quick Reference: 8-Step Checklist\n\nBefore creating any animation:\n\n1. **Emotional target?** — joy, calm, urgency, elegance\n2. **Motion Personality?** — Playful, Premium, Corporate, Energetic\n3. **Primary property?** — position, scale, rotation, opacity\n4. **Duration?** — see duration table below\n5. **Easing family?** — entrance=decelerate, exit=accelerate\n6. **Hero element?** — apply staging principles\n7. **Secondary + ambient layers?** — add richness\n8. **1\u002F3 rules?** — motion distance, simultaneous elements\n\n---\n\n## Three Pillars (CRITICAL)\n\nEvery animation must satisfy three pillars before any technical decisions:\n\n| Pillar | Question | Drives |\n|--------|----------|--------|\n| **Emotional Intent** | What should the viewer FEEL? | Easing, timing, amplitude |\n| **Visual Narrative** | What's the micro-story? | Setup → Action → Resolution |\n| **Motion Craft** | How do we make it believable? | Physics, secondary motion, paths |\n\n**Three motion layers** (flat animation = missing layers):\n- **Primary**: Main action the viewer follows\n- **Secondary**: Supporting richness (shadows, icons shifting)\n- **Ambient**: Background life (gradients, subtle pulses)\n\n> Deep dive: [director\u002Fcore-philosophy.md](director\u002Fcore-philosophy.md)\n\n---\n\n## Motion Personality\n\nSelect ONE archetype per project. Apply consistently.\n\n| Archetype | Duration | Easing | Overshoot | Keywords |\n|-----------|----------|--------|-----------|----------|\n| **Playful** | 150-300ms | ease-out-back | 10-20% | fun, whimsical, bouncy, cute |\n| **Premium** | 350-600ms | cubic-bezier(0.4,0,0.2,1) | 0% | elegant, minimal, luxury, sophisticated |\n| **Corporate** | 200-400ms | cubic-bezier(0.2,0,0,1) | 0-3% | clean, professional, business, dashboard |\n| **Energetic** | 100-250ms | ease-out-expo | 15-30% | dynamic, energetic, bold, exciting |\n\n**Default**: Corporate for UI, Playful for illustrations.\n\n**Brand Motion Identity** — define three constants:\n1. **Signature easing**: One curve for 80% of animations\n2. **Duration palette**: 3 durations (quick \u002F standard \u002F slow)\n3. **Entrance pattern**: One consistent entry style\n\n> Deep dive: [director\u002Fmotion-personality.md](director\u002Fmotion-personality.md)\n\n---\n\n## Property Selection\n\n| Effect Goal | Primary Property | Secondary Properties |\n|-------------|------------------|---------------------|\n| Entrance\u002FExit | position | opacity, scale |\n| Emphasis\u002FAttention | scale | rotation (subtle), opacity pulse |\n| State Change | opacity, color | scale (press feedback) |\n| Direction\u002FFlow | position | rotation (follow path) |\n| Depth\u002F3D Feel | scale + shadow | position (parallax) |\n| Loading\u002FProgress | rotation (spinner) | scale, opacity pulse |\n| Success | scale (pop) | color, rotation (checkmark draw) |\n| Error\u002FAlert | position (shake) | color, rotation (wobble) |\n\n**Simplicity threshold**: Use the minimum properties needed. One = direct. Two = polished. Three+ = potentially overwhelming.\n\n> Deep dive: [reference\u002Fproperty-selection.md](reference\u002Fproperty-selection.md)\n\n---\n\n## Duration Table\n\n| Element Type | Duration | Rationale |\n|-------------|----------|-----------|\n| Tooltip \u002F micro-feedback | 80-120ms | Must feel instant |\n| Button press \u002F toggle | 120-180ms | Responsive feedback |\n| Icon transition | 150-250ms | Clear state change |\n| Card enter \u002F exit | 200-350ms | Spatial awareness |\n| Modal \u002F dialog | 300-400ms | Focus shift |\n| Page transition | 400-600ms | Context switch |\n| Dramatic reveal | 600-1200ms | Theatrical build |\n\n**Distance scales duration**: 100px = base. 200px = 1.3x. 400px = 1.6x.\n\n**Enter > Exit**: Entrances 30-50% longer than exits. Users care about what appears.\n\n**Interactive feedback**:\n- Hover: \u003C100ms\n- Press: \u003C150ms\n- Release\u002Fsettle: 200-300ms\n- Error shake: 300-400ms (2-3 oscillations)\n\n> Deep dive: [reference\u002Ftiming-easing-tables.md](reference\u002Ftiming-easing-tables.md)\n\n---\n\n## Easing Selection\n\n**Directional rules**:\n- **Entrance** → decelerate (fast start, gentle landing): ease-out family\n- **Exit** → accelerate (gentle start, fast departure): ease-in family\n- **On-screen** → smooth both ends: ease-in-out family\n- **Looping ambient** → seamless: sine-based ease-in-out\n\n**Industry standards**:\n\n| Standard | Cubic Bezier | Use For |\n|----------|-------------|---------|\n| Material Design 3 | (0.2, 0, 0, 1) | Default on-screen |\n| MD3 Emphasized | (0.05, 0.7, 0.1, 1) | Entrances, attention |\n| MD3 Accelerate | (0.3, 0, 1, 1) | Exits, dismissals |\n| Apple HIG | (0.25, 0.1, 0.25, 1) | Standard iOS |\n| Snappy UI | (0.2, 0, 0, 1) | Fast, decisive |\n| Gentle float | (0.4, 0, 0.2, 1) | Ambient, background |\n| Bounce settle | (0.175, 0.885, 0.32, 1.275) | Overshoot, playful |\n\n**Material-based easing**:\n\n| Material | Duration Scale | Overshoot |\n|----------|---------------|-----------|\n| Rigid (metal, stone) | 1.2x | 0% |\n| Elastic (rubber, gel) | 0.8x | 15-25% |\n| Fluid (water, paint) | 1.5x | 5% |\n| Paper (cards, sheets) | 1.0x | 3-5% |\n| Gas (smoke, fog) | 2.0x | 0% |\n| Glass (brittle) | 0.9x | 0% |\n\n> Deep dive: [reference\u002Ftiming-easing-tables.md](reference\u002Ftiming-easing-tables.md)\n\n---\n\n## Common Patterns\n\n### Button Press (Playful)\n1. **Anticipation**: Scale to 0.97 (50ms, ease-out)\n2. **Squash**: Scale to [1.04, 0.96] (100ms, ease-in)\n3. **Follow through**: Overshoots to 1.02, settles to 1.0 (spring, 200ms)\n4. **Secondary**: Shadow shrinks during press, icon shifts down 2px\n5. **Total**: ~150ms press + 200ms settle\n\n### Card Entrance (Premium)\n1. **Start**: 20px below target, opacity 0\n2. **Path**: Slight curve (10px X offset at midpoint)\n3. **Easing**: ease-out-cubic deceleration\n4. **Follow through**: Shadow arrives 50ms after card\n5. **Secondary**: Content fades in 100ms after card lands\n6. **Staging**: Other cards dim to 80%\n\n### Success State (Playful)\n1. **Primary**: Scale pop with ease-out-back\n2. **Secondary**: Checkmark draws in\n3. **Ambient**: Subtle particle burst\n4. **Color**: Green fill\n5. **Total**: 300-400ms\n\n### Error Shake (Corporate)\n1. **Primary**: Position oscillates 2-3 times, ±10-15px horizontal\n2. **Easing**: ease-in-out for sharp stops\n3. **Color**: Red tint\n4. **Total**: 300-400ms\n5. **No overshoot**: Errors feel firm\n\n> More patterns: [patterns\u002Fentrance-exit.md](patterns\u002Fentrance-exit.md) | [patterns\u002Fstate-feedback.md](patterns\u002Fstate-feedback.md)\n\n---\n\n## Choreography Essentials\n\n**Coordinated entry**:\n- Lead with the hero — primary element enters first or most prominently\n- Spatial consistency — all elements enter from same direction\n- Counter-motion — hero moves right → ambient moves left at 20-30% speed\n\n**1\u002F3 Rule (distance)**: No motion travels more than 1\u002F3 of screen without a keyframe change.\n\n**1\u002F3 Rule (elements)**: With 3+ elements, no more than 1\u002F3 in active motion simultaneously.\n\n**Stagger budgets**:\n\n| Pattern | Delay | Total Budget | Use Case |\n|---------|-------|-------------|----------|\n| Micro cascade | 20-40ms | \u003C200ms | List items, grid cells |\n| Standard | 50-100ms | \u003C400ms | Cards, panels, nav |\n| Dramatic | 100-200ms | \u003C600ms | Hero sections |\n| Wave | 30-60ms | \u003C500ms | Data visualizations |\n\n**Critical**: Total stagger must stay under 500ms.\n\n> Deep dive: [director\u002Fchoreography.md](director\u002Fchoreography.md)\n\n---\n\n## Emotion-to-Motion Map\n\n| Emotion | Character | Path | Easing | Duration |\n|---------|-----------|------|--------|----------|\n| Joy | Bouncy, arcs | Curved, upward | ease-out-back | 200-400ms |\n| Calm | Smooth, flowing | Gentle curves | sine ease-in-out | 500-1000ms |\n| Urgency | Sharp, fast | Straight lines | ease-out | 100-200ms |\n| Sadness | Slow, downward | Drooping curves | cubic ease-in-out | 600-1200ms |\n| Surprise | Sudden, expanding | Radial outward | ease-out-expo | 150-300ms |\n| Elegance | Slow, controlled | Long arcs | (0.4,0,0.2,1) | 400-700ms |\n| Playfulness | Bouncy, irregular | Arcs, squiggly | ease-out-back | 200-350ms |\n\n**Path as language**: Angular = tense. Curved = friendly. Spiral = whimsical. Diagonal = purposeful. Vertical = growth\u002Fweight. Horizontal = progress.\n\n> Deep dive: [director\u002Femotion-mapping.md](director\u002Femotion-mapping.md)\n\n---\n\n## Weight Classification\n\n| Weight | Examples | Duration | Overshoot | Easing |\n|--------|----------|----------|-----------|--------|\n| Heavy | Modals, overlays | 300-500ms | 0% | Gentle, high damping |\n| Medium | Cards, panels | 200-350ms | 3-5% | Moderate |\n| Light | Tooltips, badges, icons | 80-200ms | 5-15% | Responsive |\n\n---\n\n## Quality Rules\n\n### CRITICAL — never break\n1. **Never linear for spatial movement** — always use easing curves (linear only for spinners, progress bars)\n2. **Never opacity-only** for important state changes — combine with position or scale\n3. **Never exceed 1\u002F3 screen** without intermediate keyframe\n4. **Always three motion layers** — primary + secondary + ambient\n\n### HIGH — strongly follow\n1. Match duration to element type (see tables)\n2. Use directional easing (ease-out entrance, ease-in exit)\n3. Apply Disney principles (especially anticipation, follow-through)\n4. Maintain consistent personality across scene\n\n> Full checklist: [reference\u002Fquality-checklist.md](reference\u002Fquality-checklist.md)\n\n---\n\n## Troubleshooting Quick Reference\n\n| Problem | Likely Cause | Fix |\n|---------|-------------|-----|\n| Looks robotic | Linear easing or no arcs | Add easing curves + arc paths |\n| Feels too slow | Duration too long for element type | Check duration table, use ease-out |\n| Feels cheap\u002Fflat | Missing secondary + ambient | Add shadow motion + background life |\n| Too distracting | Too many elements moving | Apply 1\u002F3 rule, reduce amplitude |\n| No personality | Generic easing everywhere | Apply personality archetype consistently |\n\n> Deep dive: [reference\u002Ftroubleshooting.md](reference\u002Ftroubleshooting.md)\n\n---\n\n## File Reference\n\n**Philosophy** (director\u002F):\n- [core-philosophy.md](director\u002Fcore-philosophy.md) — Three Pillars deep dive\n- [decision-framework.md](director\u002Fdecision-framework.md) — Full decision pipeline\n- [disney-principles.md](director\u002Fdisney-principles.md) — 12 principles, UI-adapted\n- [motion-personality.md](director\u002Fmotion-personality.md) — 4 archetypes + brand identity\n- [emotion-mapping.md](director\u002Femotion-mapping.md) — Emotion → motion + color psychology\n- [choreography.md](director\u002Fchoreography.md) — Multi-element coordination\n- [narrative-structure.md](director\u002Fnarrative-structure.md) — Micro-story framework\n- [context-adaptation.md](director\u002Fcontext-adaptation.md) — Platform, a11y, performance\n\n**Reference** (reference\u002F):\n- [timing-easing-tables.md](reference\u002Ftiming-easing-tables.md) — Duration + easing lookups\n- [property-selection.md](reference\u002Fproperty-selection.md) — Property communication guide\n- [troubleshooting.md](reference\u002Ftroubleshooting.md) — Animation smells + fixes\n- [quality-checklist.md](reference\u002Fquality-checklist.md) — Evaluation criteria\n\n**Patterns** (patterns\u002F):\n- [entrance-exit.md](patterns\u002Fentrance-exit.md) — Entrance\u002Fexit recipes\n- [state-feedback.md](patterns\u002Fstate-feedback.md) — Success, error, loading, hover\n- [ambient-continuous.md](patterns\u002Fambient-continuous.md) — Looping, breathing, parallax\n- [multi-element.md](patterns\u002Fmulti-element.md) — Stagger + choreography recipes\n","# Motion Design Skill\n\n## When to Apply\n\nUse this skill when:\n- Creating UI animations (buttons, cards, modals, page transitions)\n- Designing micro-interactions and feedback animations\n- Building loading, success, or error states\n- Animating illustrations or decorative elements\n- Planning scroll-triggered or progress-based animations\n- Establishing brand motion identity\n- Choreographing multi-element sequences\n\n**Decision tree:**\n1. Does it serve a functional purpose (feedback, guidance)? → Timing rules for responsiveness\n2. Does it express brand personality? → Motion Personality archetypes\n3. Does it tell a story or guide attention? → Disney principles + choreography\n4. Is this a complex multi-element scene? → 1\u002F3 Rule + stagger patterns\n\n---\n\n## Quick Reference: 8-Step Checklist\n\nBefore creating any animation:\n\n1. **Emotional target?** — joy, calm, urgency, elegance\n2. **Motion Personality?** — Playful, Premium, Corporate, Energetic\n3. **Primary property?** — position, scale, rotation, opacity\n4. **Duration?** — see duration table below\n5. **Easing family?** — entrance=decelerate, exit=accelerate\n6. **Hero element?** — apply staging principles\n7. **Secondary + ambient layers?** — add richness\n8. **1\u002F3 rules?** — motion distance, simultaneous elements\n\n---\n\n## Three Pillars (CRITICAL)\n\nEvery animation must satisfy three pillars before any technical decisions:\n\n| Pillar | Question | Drives |\n|--------|----------|--------|\n| **Emotional Intent** | What should the viewer FEEL? | Easing, timing, amplitude |\n| **Visual Narrative** | What's the micro-story? | Setup → Action → Resolution |\n| **Motion Craft** | How do we make it believable? | Physics, secondary motion, paths |\n\n**Three motion layers** (flat animation = missing layers):\n- **Primary**: Main action the viewer follows\n- **Secondary**: Supporting richness (shadows, icons shifting)\n- **Ambient**: Background life (gradients, subtle pulses)\n\n> Deep dive: [director\u002Fcore-philosophy.md](director\u002Fcore-philosophy.md)\n\n---\n\n## Motion Personality\n\nSelect ONE archetype per project. Apply consistently.\n\n| Archetype | Duration | Easing | Overshoot | Keywords |\n|-----------|----------|--------|-----------|----------|\n| **Playful** | 150-300ms | ease-out-back | 10-20% | fun, whimsical, bouncy, cute |\n| **Premium** | 350-600ms | cubic-bezier(0.4,0,0.2,1) | 0% | elegant, minimal, luxury, sophisticated |\n| **Corporate** | 200-400ms | cubic-bezier(0.2,0,0,1) | 0-3% | clean, professional, business, dashboard |\n| **Energetic** | 100-250ms | ease-out-expo | 15-30% | dynamic, energetic, bold, exciting |\n\n**Default**: Corporate for UI, Playful for illustrations.\n\n**Brand Motion Identity** — define three constants:\n1. **Signature easing**: One curve for 80% of animations\n2. **Duration palette**: 3 durations (quick \u002F standard \u002F slow)\n3. **Entrance pattern**: One consistent entry style\n\n> Deep dive: [director\u002Fmotion-personality.md](director\u002Fmotion-personality.md)\n\n---\n\n## Property Selection\n\n| Effect Goal | Primary Property | Secondary Properties |\n|-------------|------------------|---------------------|\n| Entrance\u002FExit | position | opacity, scale |\n| Emphasis\u002FAttention | scale | rotation (subtle), opacity pulse |\n| State Change | opacity, color | scale (press feedback) |\n| Direction\u002FFlow | position | rotation (follow path) |\n| Depth\u002F3D Feel | scale + shadow | position (parallax) |\n| Loading\u002FProgress | rotation (spinner) | scale, opacity pulse |\n| Success | scale (pop) | color, rotation (checkmark draw) |\n| Error\u002FAlert | position (shake) | color, rotation (wobble) |\n\n**Simplicity threshold**: Use the minimum properties needed. One = direct. Two = polished. Three+ = potentially overwhelming.\n\n> Deep dive: [reference\u002Fproperty-selection.md](reference\u002Fproperty-selection.md)\n\n---\n\n## Duration Table\n\n| Element Type | Duration | Rationale |\n|-------------|----------|-----------|\n| Tooltip \u002F micro-feedback | 80-120ms | Must feel instant |\n| Button press \u002F toggle | 120-180ms | Responsive feedback |\n| Icon transition | 150-250ms | Clear state change |\n| Card enter \u002F exit | 200-350ms | Spatial awareness |\n| Modal \u002F dialog | 300-400ms | Focus shift |\n| Page transition | 400-600ms | Context switch |\n| Dramatic reveal | 600-1200ms | Theatrical build |\n\n**Distance scales duration**: 100px = base. 200px = 1.3x. 400px = 1.6x.\n\n**Enter > Exit**: Entrances 30-50% longer than exits. Users care about what appears.\n\n**Interactive feedback**:\n- Hover: \u003C100ms\n- Press: \u003C150ms\n- Release\u002Fsettle: 200-300ms\n- Error shake: 300-400ms (2-3 oscillations)\n\n> Deep dive: [reference\u002Ftiming-easing-tables.md](reference\u002Ftiming-easing-tables.md)\n\n---\n\n## Easing Selection\n\n**Directional rules**:\n- **Entrance** → decelerate (fast start, gentle landing): ease-out family\n- **Exit** → accelerate (gentle start, fast departure): ease-in family\n- **On-screen** → smooth both ends: ease-in-out family\n- **Looping ambient** → seamless: sine-based ease-in-out\n\n**Industry standards**:\n\n| Standard | Cubic Bezier | Use For |\n|----------|-------------|---------|\n| Material Design 3 | (0.2, 0, 0, 1) | Default on-screen |\n| MD3 Emphasized | (0.05, 0.7, 0.1, 1) | Entrances, attention |\n| MD3 Accelerate | (0.3, 0, 1, 1) | Exits, dismissals |\n| Apple HIG | (0.25, 0.1, 0.25, 1) | Standard iOS |\n| Snappy UI | (0.2, 0, 0, 1) | Fast, decisive |\n| Gentle float | (0.4, 0, 0.2, 1) | Ambient, background |\n| Bounce settle | (0.175, 0.885, 0.32, 1.275) | Overshoot, playful |\n\n**Material-based easing**:\n\n| Material | Duration Scale | Overshoot |\n|----------|---------------|-----------|\n| Rigid (metal, stone) | 1.2x | 0% |\n| Elastic (rubber, gel) | 0.8x | 15-25% |\n| Fluid (water, paint) | 1.5x | 5% |\n| Paper (cards, sheets) | 1.0x | 3-5% |\n| Gas (smoke, fog) | 2.0x | 0% |\n| Glass (brittle) | 0.9x | 0% |\n\n> Deep dive: [reference\u002Ftiming-easing-tables.md](reference\u002Ftiming-easing-tables.md)\n\n---\n\n## Common Patterns\n\n### Button Press (Playful)\n1. **Anticipation**: Scale to 0.97 (50ms, ease-out)\n2. **Squash**: Scale to [1.04, 0.96] (100ms, ease-in)\n3. **Follow through**: Overshoots to 1.02, settles to 1.0 (spring, 200ms)\n4. **Secondary**: Shadow shrinks during press, icon shifts down 2px\n5. **Total**: ~150ms press + 200ms settle\n\n### Card Entrance (Premium)\n1. **Start**: 20px below target, opacity 0\n2. **Path**: Slight curve (10px X offset at midpoint)\n3. **Easing**: ease-out-cubic deceleration\n4. **Follow through**: Shadow arrives 50ms after card\n5. **Secondary**: Content fades in 100ms after card lands\n6. **Staging**: Other cards dim to 80%\n\n### Success State (Playful)\n1. **Primary**: Scale pop with ease-out-back\n2. **Secondary**: Checkmark draws in\n3. **Ambient**: Subtle particle burst\n4. **Color**: Green fill\n5. **Total**: 300-400ms\n\n### Error Shake (Corporate)\n1. **Primary**: Position oscillates 2-3 times, ±10-15px horizontal\n2. **Easing**: ease-in-out for sharp stops\n3. **Color**: Red tint\n4. **Total**: 300-400ms\n5. **No overshoot**: Errors feel firm\n\n> More patterns: [patterns\u002Fentrance-exit.md](patterns\u002Fentrance-exit.md) | [patterns\u002Fstate-feedback.md](patterns\u002Fstate-feedback.md)\n\n---\n\n## Choreography Essentials\n\n**Coordinated entry**:\n- Lead with the hero — primary element enters first or most prominently\n- Spatial consistency — all elements enter from same direction\n- Counter-motion — hero moves right → ambient moves left at 20-30% speed\n\n**1\u002F3 Rule (distance)**: No motion travels more than 1\u002F3 of screen without a keyframe change.\n\n**1\u002F3 Rule (elements)**: With 3+ elements, no more than 1\u002F3 in active motion simultaneously.\n\n**Stagger budgets**:\n\n| Pattern | Delay | Total Budget | Use Case |\n|---------|-------|-------------|----------|\n| Micro cascade | 20-40ms | \u003C200ms | List items, grid cells |\n| Standard | 50-100ms | \u003C400ms | Cards, panels, nav |\n| Dramatic | 100-200ms | \u003C600ms | Hero sections |\n| Wave | 30-60ms | \u003C500ms | Data visualizations |\n\n**Critical**: Total stagger must stay under 500ms.\n\n> Deep dive: [director\u002Fchoreography.md](director\u002Fchoreography.md)\n\n---\n\n## Emotion-to-Motion Map\n\n| Emotion | Character | Path | Easing | Duration |\n|---------|-----------|------|--------|----------|\n| Joy | Bouncy, arcs | Curved, upward | ease-out-back | 200-400ms |\n| Calm | Smooth, flowing | Gentle curves | sine ease-in-out | 500-1000ms |\n| Urgency | Sharp, fast | Straight lines | ease-out | 100-200ms |\n| Sadness | Slow, downward | Drooping curves | cubic ease-in-out | 600-1200ms |\n| Surprise | Sudden, expanding | Radial outward | ease-out-expo | 150-300ms |\n| Elegance | Slow, controlled | Long arcs | (0.4,0,0.2,1) | 400-700ms |\n| Playfulness | Bouncy, irregular | Arcs, squiggly | ease-out-back | 200-350ms |\n\n**Path as language**: Angular = tense. Curved = friendly. Spiral = whimsical. Diagonal = purposeful. Vertical = growth\u002Fweight. Horizontal = progress.\n\n> Deep dive: [director\u002Femotion-mapping.md](director\u002Femotion-mapping.md)\n\n---\n\n## Weight Classification\n\n| Weight | Examples | Duration | Overshoot | Easing |\n|--------|----------|----------|-----------|--------|\n| Heavy | Modals, overlays | 300-500ms | 0% | Gentle, high damping |\n| Medium | Cards, panels | 200-350ms | 3-5% | Moderate |\n| Light | Tooltips, badges, icons | 80-200ms | 5-15% | Responsive |\n\n---\n\n## Quality Rules\n\n### CRITICAL — never break\n1. **Never linear for spatial movement** — always use easing curves (linear only for spinners, progress bars)\n2. **Never opacity-only** for important state changes — combine with position or scale\n3. **Never exceed 1\u002F3 screen** without intermediate keyframe\n4. **Always three motion layers** — primary + secondary + ambient\n\n### HIGH — strongly follow\n1. Match duration to element type (see tables)\n2. Use directional easing (ease-out entrance, ease-in exit)\n3. Apply Disney principles (especially anticipation, follow-through)\n4. Maintain consistent personality across scene\n\n> Full checklist: [reference\u002Fquality-checklist.md](reference\u002Fquality-checklist.md)\n\n---\n\n## Troubleshooting Quick Reference\n\n| Problem | Likely Cause | Fix |\n|---------|-------------|-----|\n| Looks robotic | Linear easing or no arcs | Add easing curves + arc paths |\n| Feels too slow | Duration too long for element type | Check duration table, use ease-out |\n| Feels cheap\u002Fflat | Missing secondary + ambient | Add shadow motion + background life |\n| Too distracting | Too many elements moving | Apply 1\u002F3 rule, reduce amplitude |\n| No personality | Generic easing everywhere | Apply personality archetype consistently |\n\n> Deep dive: [reference\u002Ftroubleshooting.md](reference\u002Ftroubleshooting.md)\n\n---\n\n## File Reference\n\n**Philosophy** (director\u002F):\n- [core-philosophy.md](director\u002Fcore-philosophy.md) — Three Pillars deep dive\n- [decision-framework.md](director\u002Fdecision-framework.md) — Full decision pipeline\n- [disney-principles.md](director\u002Fdisney-principles.md) — 12 principles, UI-adapted\n- [motion-personality.md](director\u002Fmotion-personality.md) — 4 archetypes + brand identity\n- [emotion-mapping.md](director\u002Femotion-mapping.md) — Emotion → motion + color psychology\n- [choreography.md](director\u002Fchoreography.md) — Multi-element coordination\n- [narrative-structure.md](director\u002Fnarrative-structure.md) — Micro-story framework\n- [context-adaptation.md](director\u002Fcontext-adaptation.md) — Platform, a11y, performance\n\n**Reference** (reference\u002F):\n- [timing-easing-tables.md](reference\u002Ftiming-easing-tables.md) — Duration + easing lookups\n- [property-selection.md](reference\u002Fproperty-selection.md) — Property communication guide\n- [troubleshooting.md](reference\u002Ftroubleshooting.md) — Animation smells + fixes\n- [quality-checklist.md](reference\u002Fquality-checklist.md) — Evaluation criteria\n\n**Patterns** (patterns\u002F):\n- [entrance-exit.md](patterns\u002Fentrance-exit.md) — Entrance\u002Fexit recipes\n- [state-feedback.md](patterns\u002Fstate-feedback.md) — Success, error, loading, hover\n- [ambient-continuous.md](patterns\u002Fambient-continuous.md) — Looping, breathing, parallax\n- [multi-element.md](patterns\u002Fmulti-element.md) — Stagger + choreography recipes\n",{"name":5,"license":15,"metadata":24,"description":27},{"author":25,"version":26},"LottieFiles","1.0.0","Applies motion design principles to create emotionally-driven, technically sound animations and transitions. Provides timing, easing, choreography, and Disney animation principles adapted for UI. Use when creating animations, transitions, micro-interactions, loading states, page transitions, scroll-triggered effects, or any motion work. Works with CSS, Framer Motion, GSAP, Lottie, Spring, or any animation system.\n","master","5c76a0f7d7c7acf1dfe7fc5f8bf2658edfffa73c","skills\u002Fmotion-design",0,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator","https:\u002F\u002Fgithub.com\u002Figun997","https:\u002F\u002Flazyindra.online","Optimizing laziness into efficiency","2026-05-28 22:21:30",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add igun997\u002Fpi-orchestrator --skill motion-design",{"tool":43,"command":44},"bunx","bunx skills add igun997\u002Fpi-orchestrator --skill motion-design",{"tool":46,"command":47},"pnpm","pnpm dlx skills add igun997\u002Fpi-orchestrator --skill motion-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002FSKILL.md",true,[51,57,61,65,69,73,77,81,85,89,93,97,101,105,109,113,117],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"director\u002Fchoreography.md","REFERENCE","参考文档",3035,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Fchoreography.md",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"director\u002Fcontext-adaptation.md",3066,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Fcontext-adaptation.md",{"path":62,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":63,"sourceHtmlUrl":64},"director\u002Fcore-philosophy.md",1864,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Fcore-philosophy.md",{"path":66,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":67,"sourceHtmlUrl":68},"director\u002Fdecision-framework.md",2866,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Fdecision-framework.md",{"path":70,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":71,"sourceHtmlUrl":72},"director\u002Fdisney-principles.md",3197,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Fdisney-principles.md",{"path":74,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":75,"sourceHtmlUrl":76},"director\u002Femotion-mapping.md",2877,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Femotion-mapping.md",{"path":78,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":79,"sourceHtmlUrl":80},"director\u002Fmotion-personality.md",2998,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Fmotion-personality.md",{"path":82,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":83,"sourceHtmlUrl":84},"director\u002Fnarrative-structure.md",2407,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fdirector\u002Fnarrative-structure.md",{"path":86,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":87,"sourceHtmlUrl":88},"package.json",245,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fpackage.json",{"path":90,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":91,"sourceHtmlUrl":92},"patterns\u002Fambient-continuous.md",2823,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fpatterns\u002Fambient-continuous.md",{"path":94,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":95,"sourceHtmlUrl":96},"patterns\u002Fentrance-exit.md",2822,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fpatterns\u002Fentrance-exit.md",{"path":98,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":99,"sourceHtmlUrl":100},"patterns\u002Fmulti-element.md",2362,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fpatterns\u002Fmulti-element.md",{"path":102,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":103,"sourceHtmlUrl":104},"patterns\u002Fstate-feedback.md",3062,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Fpatterns\u002Fstate-feedback.md",{"path":106,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":107,"sourceHtmlUrl":108},"reference\u002Fproperty-selection.md",2922,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Freference\u002Fproperty-selection.md",{"path":110,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":111,"sourceHtmlUrl":112},"reference\u002Fquality-checklist.md",2080,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Freference\u002Fquality-checklist.md",{"path":114,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":115,"sourceHtmlUrl":116},"reference\u002Ftiming-easing-tables.md",2900,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Freference\u002Ftiming-easing-tables.md",{"path":118,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":119,"sourceHtmlUrl":120},"reference\u002Ftroubleshooting.md",2709,"https:\u002F\u002Fgithub.com\u002Figun997\u002Fpi-orchestrator\u002Fblob\u002Fmaster\u002Fskills\u002Fmotion-design\u002Freference\u002Ftroubleshooting.md",[]]