[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MMKBN7SW88VKKWZFE9QS5":3,"skill-same:01M75MMKBN7SW88VKKWZFE9QS5":69},{"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":46,"commitSha":47,"skillDirectory":48,"forksCount":49,"repositoryHtmlUrl":50,"repositoryHomepageUrl":51,"ownerHtmlUrl":52,"ownerBlogUrl":6,"ownerDescription":53,"updatedAt":54,"install":55,"resources":68},"01M75MMKBN7SW88VKKWZFE9QS5","motion-dev-animations",null,"Creates 120fps GPU-accelerated animations with Motion.dev (Framer Motion successor) for React, Next.js, Svelte, and Astro projects. Use when user requests animation, motion, scroll effects, parallax, hero animations, gestures, drag interactions, spring physics, whileHover effects, whileInView animations, animated UI, micro-interactions, page transitions, or layout animations. Generates production TypeScript\u002FJSX code with accessibility (prefers-reduced-motion) and performance validation (≥60fps). Supports entrance animations, gesture interactions (hover\u002Ftap\u002Fdrag), scroll-based reveals, and layout transitions using spring physics and natural timing. Do NOT use for CSS-only transitions (use native CSS), static sites without JavaScript, Vue animations (use motion-v variant instead), or SVG\u002FCanvas complex animations (GSAP better suited).","whimzyLive\u002Fnightshift-ai","whimzyLive","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22066605?v=4","01M75MMH22XX6R3NTAFHD7HEN7","Rushi Patel","01M75MMH32DHVVC61XRSHWVEV2",3,"MIT","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fmotion-dev-animations\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: motion-dev-animations\ndescription: Creates 120fps GPU-accelerated animations with Motion.dev (Framer Motion successor) for React, Next.js, Svelte, and Astro projects. Use when user requests animation, motion, scroll effects, parallax, hero animations, gestures, drag interactions, spring physics, whileHover effects, whileInView animations, animated UI, micro-interactions, page transitions, or layout animations. Generates production TypeScript\u002FJSX code with accessibility (prefers-reduced-motion) and performance validation (≥60fps). Supports entrance animations, gesture interactions (hover\u002Ftap\u002Fdrag), scroll-based reveals, and layout transitions using spring physics and natural timing. Do NOT use for CSS-only transitions (use native CSS), static sites without JavaScript, Vue animations (use motion-v variant instead), or SVG\u002FCanvas complex animations (GSAP better suited).\nallowed-tools: Read, Write, Edit, Bash, Glob, Grep\nmetadata:\n  version: '3.0.0'\n  author: 'Motion Dev Standards'\n  tags: ['motion', 'framer-motion', 'animation', 'react', 'nextjs', 'svelte', 'astro', 'gestures', 'scroll', 'parallax', 'microinteractions', 'spring-physics', 'layout-animations']\n  min_claude_version: '3.5'\n  created: '2025-11-07'\n  updated: '2025-11-08'\n  optimization: 'Research-backed: imperative language, few-shot (3 examples), layered complexity, progressive loading'\n---\n\n# Motion Dev Animations\n\n> **Motion.dev** - 10M+ downloads\u002Fmonth, successor to Framer Motion\n> 120fps GPU-accelerated animations for React, Next.js, Svelte, Astro, Vue\n\n## Purpose\n\nGenerate production-grade animations using Motion.dev following Apple\u002FJon Ive principles:\n**Purposeful** (serves function) | **Smooth** (120fps) | **Accessible** (reduced-motion) | **Performant** (GPU-only) | **Elegant** (subtle) | **Consistent** (unified timing)\n\n## When to Use\n\n✅ **Use for**:\n\n- React 19+\u002FNext.js 15+\u002FSvelte 5+\u002FAstro 4+ animation implementation\n- Scroll effects (parallax, reveal), gestures (hover, drag, tap), layout animations\n- Hero sections, cards, micro-interactions requiring 60fps+ performance\n- Projects needing spring physics, natural motion, accessibility\n\n❌ **Don't use for**:\n\n- CSS-only transitions (use native `transition` property)\n- Static sites without JavaScript frameworks\n- Vue projects (use `motion-v` package - different API)\n- SVG\u002FCanvas complex animations (GSAP better suited)\n- Form-only CRUD apps (overkill)\n\n## Workflow: Clarify → Plan → Implement → Verify\n\n### Step 1: Clarify Requirements\n\nDetermine project context and animation goals:\n\n- Framework (React 19+, Next.js 15+, Svelte 5+, Astro 4+)\n- Animation type (entrance, gesture, scroll, layout)\n- Design goal (subtle, prominent, playful, professional)\n- Performance constraints (target device, bundle limits, accessibility requirements)\n- Trigger mechanism (mount, viewport, user interaction)\n\n### Step 2: Plan Animation Strategy\n\nDefine implementation approach:\n\n- Components to animate (headers, cards, buttons, sections)\n- Motion patterns (fade, slide, scale, spring, parallax)\n- Timing specifications (duration, delay, stagger intervals)\n- Physics parameters (stiffness: 300-400, damping: 20, mass: 1)\n- Accessibility fallbacks (prefers-reduced-motion alternatives)\n\n### Step 3: Implement in Phases\n\nBuild animations incrementally:\n\n- **Setup**: Install Motion.dev, configure imports, prepare component structure\n- **Core Animation**: Apply motion properties (initial, animate, transition)\n- **Refinement**: Tune timing, easing curves, spring physics for natural feel\n- **Accessibility**: Add reduced-motion detection, keyboard navigation support\n- **Optimization**: Verify GPU-acceleration, minimize bundle size, test performance\n\n### Step 4: Verify Quality Standards\n\nCheck against requirements:\n\n- **Performance**: ≥60fps (Chrome DevTools → Performance tab)\n- **Layout Stability**: CLS = 0 (Lighthouse audit)\n- **Accessibility**: Honors prefers-reduced-motion (system settings test)\n- **Keyboard Navigation**: All interactive elements keyboard-accessible\n- **Mobile Responsive**: Touch-friendly gestures, tested on iOS\u002FAndroid\n\n## Animation Pattern Decision Tree\n\n```\nINPUT: What should animate?\n\n├─ ENTRANCE (page load, mount)\n│   → Pattern: initial={{opacity: 0, y: 20}} animate={{opacity: 1, y: 0}}\n│   → Timing: 0.6-0.8s, ease: [0.22, 1, 0.36, 1]\n│   → Stagger: 0.1-0.2s between elements\n│   → Example: .\u002Fexamples\u002Fhero-fade-up.md\n│\n├─ GESTURE (hover, tap, drag)\n│   → Pattern: whileHover={{scale: 1.05}}, whileTap={{scale: 0.95}}\n│   → Physics: Spring (stiffness: 300-400, damping: 20)\n│   → Timing: Instant response (no duration)\n│   → Examples: .\u002Fexamples\u002Fcard-hover.md, .\u002Fexamples\u002Fmagnetic-button.md\n│\n├─ SCROLL (reveal, parallax)\n│   → Pattern: whileInView + viewport OR useScroll + useTransform\n│   → Trigger: viewport={{once: true, amount: 0.3}}\n│   → Performance: Transform\u002Fopacity only\n│   → Examples: .\u002Fexamples\u002Fscroll-reveal.md, .\u002Fexamples\u002Fparallax-layers.md\n│\n└─ LAYOUT (reorder, expand)\n    → Pattern: layout prop (auto FLIP)\n    → Shared: layoutId=\"id\" for morphing\n    → Caveat: Only animates transforms\n```\n\n## API Quick Reference\n\n| Component\u002FHook   | Usage                             | When                    |\n| ---------------- | --------------------------------- | ----------------------- |\n| **motion.div**   | `\u003Cmotion.div animate={{x: 100}}>` | Basic animations        |\n| **whileHover**   | `whileHover={{scale: 1.05}}`      | Hover states (0.2-0.3s) |\n| **whileTap**     | `whileTap={{scale: 0.95}}`        | Click feedback          |\n| **whileInView**  | `whileInView={{opacity: 1}}`      | Scroll reveal           |\n| **drag**         | `drag=\"x\"` dragConstraints        | Draggable elements      |\n| **layout**       | `\u003Cmotion.div layout \u002F>`           | Auto FLIP animation     |\n| **useScroll**    | Track scroll progress             | Parallax, progress bars |\n| **useTransform** | Map values                        | Scroll-linked effects   |\n| **useSpring**    | Spring physics                    | Smooth value changes    |\n| **useInView**    | Viewport detection                | Trigger animations      |\n\n**Full API**: See [Complete API Reference](.\u002Freference\u002Fapi-reference.md)\n\n## Framework Integration\n\n| Framework         | Import           | Components     | Exit Animations     |\n| ----------------- | ---------------- | -------------- | ------------------- |\n| **React\u002FNext.js** | `\"motion\u002Freact\"` | `\u003Cmotion.div>` | `\u003CAnimatePresence>` |\n| **Svelte**        | `\"motion\"`       | Vanilla API    | N\u002FA                 |\n| **Astro**         | `\"motion\"`       | Client scripts | N\u002FA                 |\n| **Vue**           | `\"motion-v\"`     | `\u003Cmotion.div>` | Similar to React    |\n\n## Quality Standards\n\n| Category          | Requirement            | How to Verify                 |\n| ----------------- | ---------------------- | ----------------------------- |\n| **Performance**   | ≥60fps                 | Chrome DevTools → Performance |\n| **GPU-accel**     | transform\u002Fopacity only | No width\u002Fheight\u002Fleft\u002Ftop      |\n| **Bundle**        | \u003C50KB                  | webpack-bundle-analyzer       |\n| **Accessibility** | prefers-reduced-motion | System settings test          |\n| **Mobile**        | Touch-friendly         | iOS\u002FAndroid testing           |\n| **Layout shift**  | CLS = 0                | Lighthouse audit              |\n\n## Examples Library (Progressive Loading)\n\nLoad on-demand based on animation type:\n\n### Hero Sections\n\n- [Hero Fade Up](.\u002Fexamples\u002Fhero-fade-up.md) - Classic Apple-style entrance\n- Hero Stagger - Orchestrated elements\n- Hero Split Text - Character reveal\n\n### Scroll Effects\n\n- [Scroll Reveal](.\u002Fexamples\u002Fscroll-reveal.md) - Intersection Observer fade-in\n- [Parallax Layers](.\u002Fexamples\u002Fparallax-layers.md) - Multi-speed depth\n- Scroll Progress - Reading indicator\n\n### Gestures & Interactions\n\n- [Card Hover](.\u002Fexamples\u002Fcard-hover.md) - Elegant lift + shadow\n- [Magnetic Button](.\u002Fexamples\u002Fmagnetic-button.md) - Cursor-following\n- Drag Carousel - Touch slider\n\n### Layout Animations\n\n- List Reorder - Drag-to-reorder FLIP\n- Accordion - Expand\u002Fcollapse\n- Tab Switch - Shared layout\n\n**Full examples**: All files in `.\u002Fexamples\u002F` directory\n\n## Reference Documentation (Load On-Demand)\n\n- [Complete API Reference](.\u002Freference\u002Fapi-reference.md) - All components, hooks, props\n- [Spring Physics Guide](.\u002Freference\u002Fspring-physics.md) - Tuning stiffness, damping, mass\n- Performance Optimization - GPU, will-change, lazy loading\n- Accessibility Guide - Reduced motion, keyboard, screen readers\n- Troubleshooting - Common issues, solutions\n- Framer Motion Migration - Upgrade guide\n\n## Templates (Production-Ready)\n\n- [Next.js Page Template](.\u002Ftemplates\u002Fnextjs-page.tsx) - Hero + features + testimonials\n- [Component Library](.\u002Ftemplates\u002Fcomponent-library.tsx) - 10+ reusable components\n- Scroll Template - Parallax + reveal patterns\n- Dashboard Template - Interactive cards, charts\n\n## Installation\n\n```bash\n# React\u002FNext.js\u002FSvelte\u002FAstro\nnpm install motion\n\n# Vue\nnpm install motion-v\n```\n\n## Common Patterns (Copy-Paste Ready)\n\n### Pattern 1: Fade Up Entrance\n\n```tsx\n\u003Cmotion.div initial={{ opacity: 0, y: 20 }} animate={{ opacity: 1, y: 0 }} transition={{ duration: 0.6, ease: [0.22, 1, 0.36, 1] }} \u002F>\n```\n\n### Pattern 2: Hover Card\n\n```tsx\n\u003Cmotion.div whileHover={{ y: -8, boxShadow: '0 20px 40px rgba(0,0,0,0.12)' }} transition={{ type: 'spring', stiffness: 300, damping: 20 }} \u002F>\n```\n\n### Pattern 3: Scroll Reveal\n\n```tsx\n\u003Cmotion.div initial={{ opacity: 0, y: 50 }} whileInView={{ opacity: 1, y: 0 }} viewport={{ once: true, amount: 0.3 }} \u002F>\n```\n\n**More patterns**: Staggered lists, exit animations, layout transitions → `.\u002Fexamples\u002F` directory\n\n## Error Handling\n\n| Issue                     | Solution                                     |\n| ------------------------- | -------------------------------------------- |\n| Animation doesn't trigger | Check initial ≠ animate values               |\n| Poor performance          | Use transform\u002Fopacity only + will-change CSS |\n| Layout shift              | Set explicit dimensions, use layout prop     |\n| Exit not working          | Wrap with `\u003CAnimatePresence>`, add key prop  |\n\n## Implementation Best Practices\n\n1. **Start simple** → Build from fade + slide, add complexity incrementally\n2. **Extract variants** → Define animation states as named variants for maintainability\n3. **Prefer spring physics** → Default to spring transitions (more natural than tween)\n4. **Stagger list items** → Use staggerChildren (0.1-0.2s) for rhythm and hierarchy\n5. **Test mobile thoroughly** → Verify touch gestures, performance on iOS\u002FAndroid devices\n6. **Include reduced-motion** → Always provide prefers-reduced-motion fallback animations\n7. **Profile performance** → Use Chrome DevTools Performance tab, target ≥60fps\n\n## Design Philosophy (Apple\u002FJon Ive Principles)\n\nApply these design principles to all animations:\n\n- **Simplicity**: Use 200-400ms durations, minimize simultaneous motion, prefer transform properties\n- **Natural Physics**: Implement spring-based transitions, avoid linear easing, apply mass-based movement\n- **Purposeful Motion**: Guide user attention, provide interaction feedback, establish visual hierarchy\n- **Elegant Restraint**: Apply \"less is more\" principle, maintain consistent timing, respect user motion preferences\n\n## Validation\n\nFor structured output validation, see:\n\n- [Motion Config Schema](.\u002Fschema\u002Fmotion-config.schema.json) - JSON schema\n- [Validation Script](.\u002Fscripts\u002Fvalidate_motion_config.py) - Automated checks\n\n## Metadata\n\n**Version**: 3.0.0 (Research-Backed Optimization)\n**Optimization**: Imperative language, few-shot patterns (3 examples), layered complexity, progressive loading\n**Token Efficiency**: 87% core reduction (15K → 2K) + auto-caching\n**Motion.dev**: v11+\n**Frameworks**: React 19+, Next.js 15+, Svelte 5+, Astro 4+, Vue 3+\n**Research**: arXiv 2402.07927v1, 2211.01910, 2310.14735v5, PubMed 40334089\n**License**: MIT\n","# Motion Dev Animations\n\n> **Motion.dev** - 10M+ downloads\u002Fmonth, successor to Framer Motion\n> 120fps GPU-accelerated animations for React, Next.js, Svelte, Astro, Vue\n\n## Purpose\n\nGenerate production-grade animations using Motion.dev following Apple\u002FJon Ive principles:\n**Purposeful** (serves function) | **Smooth** (120fps) | **Accessible** (reduced-motion) | **Performant** (GPU-only) | **Elegant** (subtle) | **Consistent** (unified timing)\n\n## When to Use\n\n✅ **Use for**:\n\n- React 19+\u002FNext.js 15+\u002FSvelte 5+\u002FAstro 4+ animation implementation\n- Scroll effects (parallax, reveal), gestures (hover, drag, tap), layout animations\n- Hero sections, cards, micro-interactions requiring 60fps+ performance\n- Projects needing spring physics, natural motion, accessibility\n\n❌ **Don't use for**:\n\n- CSS-only transitions (use native `transition` property)\n- Static sites without JavaScript frameworks\n- Vue projects (use `motion-v` package - different API)\n- SVG\u002FCanvas complex animations (GSAP better suited)\n- Form-only CRUD apps (overkill)\n\n## Workflow: Clarify → Plan → Implement → Verify\n\n### Step 1: Clarify Requirements\n\nDetermine project context and animation goals:\n\n- Framework (React 19+, Next.js 15+, Svelte 5+, Astro 4+)\n- Animation type (entrance, gesture, scroll, layout)\n- Design goal (subtle, prominent, playful, professional)\n- Performance constraints (target device, bundle limits, accessibility requirements)\n- Trigger mechanism (mount, viewport, user interaction)\n\n### Step 2: Plan Animation Strategy\n\nDefine implementation approach:\n\n- Components to animate (headers, cards, buttons, sections)\n- Motion patterns (fade, slide, scale, spring, parallax)\n- Timing specifications (duration, delay, stagger intervals)\n- Physics parameters (stiffness: 300-400, damping: 20, mass: 1)\n- Accessibility fallbacks (prefers-reduced-motion alternatives)\n\n### Step 3: Implement in Phases\n\nBuild animations incrementally:\n\n- **Setup**: Install Motion.dev, configure imports, prepare component structure\n- **Core Animation**: Apply motion properties (initial, animate, transition)\n- **Refinement**: Tune timing, easing curves, spring physics for natural feel\n- **Accessibility**: Add reduced-motion detection, keyboard navigation support\n- **Optimization**: Verify GPU-acceleration, minimize bundle size, test performance\n\n### Step 4: Verify Quality Standards\n\nCheck against requirements:\n\n- **Performance**: ≥60fps (Chrome DevTools → Performance tab)\n- **Layout Stability**: CLS = 0 (Lighthouse audit)\n- **Accessibility**: Honors prefers-reduced-motion (system settings test)\n- **Keyboard Navigation**: All interactive elements keyboard-accessible\n- **Mobile Responsive**: Touch-friendly gestures, tested on iOS\u002FAndroid\n\n## Animation Pattern Decision Tree\n\n```\nINPUT: What should animate?\n\n├─ ENTRANCE (page load, mount)\n│   → Pattern: initial={{opacity: 0, y: 20}} animate={{opacity: 1, y: 0}}\n│   → Timing: 0.6-0.8s, ease: [0.22, 1, 0.36, 1]\n│   → Stagger: 0.1-0.2s between elements\n│   → Example: .\u002Fexamples\u002Fhero-fade-up.md\n│\n├─ GESTURE (hover, tap, drag)\n│   → Pattern: whileHover={{scale: 1.05}}, whileTap={{scale: 0.95}}\n│   → Physics: Spring (stiffness: 300-400, damping: 20)\n│   → Timing: Instant response (no duration)\n│   → Examples: .\u002Fexamples\u002Fcard-hover.md, .\u002Fexamples\u002Fmagnetic-button.md\n│\n├─ SCROLL (reveal, parallax)\n│   → Pattern: whileInView + viewport OR useScroll + useTransform\n│   → Trigger: viewport={{once: true, amount: 0.3}}\n│   → Performance: Transform\u002Fopacity only\n│   → Examples: .\u002Fexamples\u002Fscroll-reveal.md, .\u002Fexamples\u002Fparallax-layers.md\n│\n└─ LAYOUT (reorder, expand)\n    → Pattern: layout prop (auto FLIP)\n    → Shared: layoutId=\"id\" for morphing\n    → Caveat: Only animates transforms\n```\n\n## API Quick Reference\n\n| Component\u002FHook   | Usage                             | When                    |\n| ---------------- | --------------------------------- | ----------------------- |\n| **motion.div**   | `\u003Cmotion.div animate={{x: 100}}>` | Basic animations        |\n| **whileHover**   | `whileHover={{scale: 1.05}}`      | Hover states (0.2-0.3s) |\n| **whileTap**     | `whileTap={{scale: 0.95}}`        | Click feedback          |\n| **whileInView**  | `whileInView={{opacity: 1}}`      | Scroll reveal           |\n| **drag**         | `drag=\"x\"` dragConstraints        | Draggable elements      |\n| **layout**       | `\u003Cmotion.div layout \u002F>`           | Auto FLIP animation     |\n| **useScroll**    | Track scroll progress             | Parallax, progress bars |\n| **useTransform** | Map values                        | Scroll-linked effects   |\n| **useSpring**    | Spring physics                    | Smooth value changes    |\n| **useInView**    | Viewport detection                | Trigger animations      |\n\n**Full API**: See [Complete API Reference](.\u002Freference\u002Fapi-reference.md)\n\n## Framework Integration\n\n| Framework         | Import           | Components     | Exit Animations     |\n| ----------------- | ---------------- | -------------- | ------------------- |\n| **React\u002FNext.js** | `\"motion\u002Freact\"` | `\u003Cmotion.div>` | `\u003CAnimatePresence>` |\n| **Svelte**        | `\"motion\"`       | Vanilla API    | N\u002FA                 |\n| **Astro**         | `\"motion\"`       | Client scripts | N\u002FA                 |\n| **Vue**           | `\"motion-v\"`     | `\u003Cmotion.div>` | Similar to React    |\n\n## Quality Standards\n\n| Category          | Requirement            | How to Verify                 |\n| ----------------- | ---------------------- | ----------------------------- |\n| **Performance**   | ≥60fps                 | Chrome DevTools → Performance |\n| **GPU-accel**     | transform\u002Fopacity only | No width\u002Fheight\u002Fleft\u002Ftop      |\n| **Bundle**        | \u003C50KB                  | webpack-bundle-analyzer       |\n| **Accessibility** | prefers-reduced-motion | System settings test          |\n| **Mobile**        | Touch-friendly         | iOS\u002FAndroid testing           |\n| **Layout shift**  | CLS = 0                | Lighthouse audit              |\n\n## Examples Library (Progressive Loading)\n\nLoad on-demand based on animation type:\n\n### Hero Sections\n\n- [Hero Fade Up](.\u002Fexamples\u002Fhero-fade-up.md) - Classic Apple-style entrance\n- Hero Stagger - Orchestrated elements\n- Hero Split Text - Character reveal\n\n### Scroll Effects\n\n- [Scroll Reveal](.\u002Fexamples\u002Fscroll-reveal.md) - Intersection Observer fade-in\n- [Parallax Layers](.\u002Fexamples\u002Fparallax-layers.md) - Multi-speed depth\n- Scroll Progress - Reading indicator\n\n### Gestures & Interactions\n\n- [Card Hover](.\u002Fexamples\u002Fcard-hover.md) - Elegant lift + shadow\n- [Magnetic Button](.\u002Fexamples\u002Fmagnetic-button.md) - Cursor-following\n- Drag Carousel - Touch slider\n\n### Layout Animations\n\n- List Reorder - Drag-to-reorder FLIP\n- Accordion - Expand\u002Fcollapse\n- Tab Switch - Shared layout\n\n**Full examples**: All files in `.\u002Fexamples\u002F` directory\n\n## Reference Documentation (Load On-Demand)\n\n- [Complete API Reference](.\u002Freference\u002Fapi-reference.md) - All components, hooks, props\n- [Spring Physics Guide](.\u002Freference\u002Fspring-physics.md) - Tuning stiffness, damping, mass\n- Performance Optimization - GPU, will-change, lazy loading\n- Accessibility Guide - Reduced motion, keyboard, screen readers\n- Troubleshooting - Common issues, solutions\n- Framer Motion Migration - Upgrade guide\n\n## Templates (Production-Ready)\n\n- [Next.js Page Template](.\u002Ftemplates\u002Fnextjs-page.tsx) - Hero + features + testimonials\n- [Component Library](.\u002Ftemplates\u002Fcomponent-library.tsx) - 10+ reusable components\n- Scroll Template - Parallax + reveal patterns\n- Dashboard Template - Interactive cards, charts\n\n## Installation\n\n```bash\n# React\u002FNext.js\u002FSvelte\u002FAstro\nnpm install motion\n\n# Vue\nnpm install motion-v\n```\n\n## Common Patterns (Copy-Paste Ready)\n\n### Pattern 1: Fade Up Entrance\n\n```tsx\n\u003Cmotion.div initial={{ opacity: 0, y: 20 }} animate={{ opacity: 1, y: 0 }} transition={{ duration: 0.6, ease: [0.22, 1, 0.36, 1] }} \u002F>\n```\n\n### Pattern 2: Hover Card\n\n```tsx\n\u003Cmotion.div whileHover={{ y: -8, boxShadow: '0 20px 40px rgba(0,0,0,0.12)' }} transition={{ type: 'spring', stiffness: 300, damping: 20 }} \u002F>\n```\n\n### Pattern 3: Scroll Reveal\n\n```tsx\n\u003Cmotion.div initial={{ opacity: 0, y: 50 }} whileInView={{ opacity: 1, y: 0 }} viewport={{ once: true, amount: 0.3 }} \u002F>\n```\n\n**More patterns**: Staggered lists, exit animations, layout transitions → `.\u002Fexamples\u002F` directory\n\n## Error Handling\n\n| Issue                     | Solution                                     |\n| ------------------------- | -------------------------------------------- |\n| Animation doesn't trigger | Check initial ≠ animate values               |\n| Poor performance          | Use transform\u002Fopacity only + will-change CSS |\n| Layout shift              | Set explicit dimensions, use layout prop     |\n| Exit not working          | Wrap with `\u003CAnimatePresence>`, add key prop  |\n\n## Implementation Best Practices\n\n1. **Start simple** → Build from fade + slide, add complexity incrementally\n2. **Extract variants** → Define animation states as named variants for maintainability\n3. **Prefer spring physics** → Default to spring transitions (more natural than tween)\n4. **Stagger list items** → Use staggerChildren (0.1-0.2s) for rhythm and hierarchy\n5. **Test mobile thoroughly** → Verify touch gestures, performance on iOS\u002FAndroid devices\n6. **Include reduced-motion** → Always provide prefers-reduced-motion fallback animations\n7. **Profile performance** → Use Chrome DevTools Performance tab, target ≥60fps\n\n## Design Philosophy (Apple\u002FJon Ive Principles)\n\nApply these design principles to all animations:\n\n- **Simplicity**: Use 200-400ms durations, minimize simultaneous motion, prefer transform properties\n- **Natural Physics**: Implement spring-based transitions, avoid linear easing, apply mass-based movement\n- **Purposeful Motion**: Guide user attention, provide interaction feedback, establish visual hierarchy\n- **Elegant Restraint**: Apply \"less is more\" principle, maintain consistent timing, respect user motion preferences\n\n## Validation\n\nFor structured output validation, see:\n\n- [Motion Config Schema](.\u002Fschema\u002Fmotion-config.schema.json) - JSON schema\n- [Validation Script](.\u002Fscripts\u002Fvalidate_motion_config.py) - Automated checks\n\n## Metadata\n\n**Version**: 3.0.0 (Research-Backed Optimization)\n**Optimization**: Imperative language, few-shot patterns (3 examples), layered complexity, progressive loading\n**Token Efficiency**: 87% core reduction (15K → 2K) + auto-caching\n**Motion.dev**: v11+\n**Frameworks**: React 19+, Next.js 15+, Svelte 5+, Astro 4+, Vue 3+\n**Research**: arXiv 2402.07927v1, 2211.01910, 2310.14735v5, PubMed 40334089\n**License**: MIT\n",{"name":5,"metadata":24,"description":7,"allowed-tools":45},{"tags":25,"author":39,"created":40,"updated":41,"version":42,"optimization":43,"min_claude_version":44},[26,27,28,29,30,31,32,33,34,35,36,37,38],"motion","framer-motion","animation","react","nextjs","svelte","astro","gestures","scroll","parallax","microinteractions","spring-physics","layout-animations","Motion Dev Standards","2025-11-07","2025-11-08","3.0.0","Research-backed: imperative language, few-shot (3 examples), layered complexity, progressive loading","3.5","Read, Write, Edit, Bash, Glob, Grep","main","7d4ebd573a4218d5e92eced411b259f34e9203fe",".agents\u002Fskills\u002Fmotion-dev-animations",0,"https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai","https:\u002F\u002Fwithnightshift.com\u002F","https:\u002F\u002Fgithub.com\u002FwhimzyLive","Creator of @typedorm","2026-11-14 22:45:42",{"source":8,"skillName":5,"commands":56,"prompt":66,"zipAvailable":67},[57,60,63],{"tool":58,"command":59},"npx","npx skills add whimzyLive\u002Fnightshift-ai --skill motion-dev-animations",{"tool":61,"command":62},"bunx","bunx skills add whimzyLive\u002Fnightshift-ai --skill motion-dev-animations",{"tool":64,"command":65},"pnpm","pnpm dlx skills add whimzyLive\u002Fnightshift-ai --skill motion-dev-animations","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fmotion-dev-animations\u002FSKILL.md",true,[],[70,78,85,92,99,106],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":77},"01M7BCEWYHDS1FWAJ6G4CD9P54","designing-in-patterns","Use when designing, planning or auditing UI against a component library — naming surfaces with the repo's pattern vocabulary, deciding reuse versus extend versus new, exploring compositions, or writing the reuse table (component-plan.md, a spec's `## Reuse`, a UI audit). Carries the design method; the repo's own vocabulary, bundle and board rules come from project-context and the designer override.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fdesigning-in-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M75MVN6GACAC87SV9RBPBMKH","typeorm","Use when defining TypeORM entities, writing migrations, or building repository\u002Fquery-builder code in TypeScript. Covers entity and relation decorators, the Data Mapper pattern, migrations, the query builder, transactions, and multi-database configuration.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Ftypeorm\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M75MTEZV8SAZNS20YDSB7KG2","hono-api","Use when building or extending REST APIs with Hono + @hono\u002Fzod-openapi. Covers schema-first route declaration with createRoute, feature-grouped composable routers, a class-based service layer behind interfaces, the strategy pattern for multi-event webhooks, typed request validation, and auto-generated OpenAPI docs.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Fhono-api\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M75MTB91SB6HPB3ZRT20F950","electrodb","Use when defining DynamoDB entities, modeling indexes, or writing queries\u002Fmutations with the ElectroDB ORM. Covers entity schema, access patterns, CRUD operations, update expressions, and single-table design patterns.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Felectrodb\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M75MT7KT9A3XYX38TX5MY6MA","atomic-design","Use when structuring or decomposing any frontend UI into reusable components, regardless of framework. Applies Brad Frost's atomic design methodology — atoms, molecules, organisms, templates, and pages — to guide consistent component hierarchy, naming, and composition decisions.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Fatomic-design\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M75MSTQ54EY0K29PKBF212K1","writing-docs","Use when writing, restructuring, or reviewing any prose documentation — a tutorial, how-to guide, reference page, or explanation\u002Fconceptual doc — for a public docs site (e.g. Mintlify MDX, docs\u002F, README material), a getting-started guide, an API\u002FCLI reference page, or a \"why we built it this way\" conceptual page. Applies the Diátaxis framework (see https:\u002F\u002Fdiataxis.fr\u002F) — every document belongs to exactly one of the four quadrants (tutorial \u002F how-to guide \u002F reference \u002F explanation), and mixing quadrants inside one document is the single most common documentation failure. Covers the four-quadrant compass for picking the right form, per-quadrant structure templates, an anti-pattern list for quadrant drift, and generic voice\u002Fcraft rules — repo-specific voice and target output format (e.g. Mintlify MDX) are resolved from the repo's docs-manifest (falling back to project-context), never hardcoded here.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fwriting-docs\u002FSKILL.md",[],[]]