[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M799Y6TSGPMQDX0HGD5F6TXZ":3,"skill-same:01M799Y6TSGPMQDX0HGD5F6TXZ":126},{"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":42,"commitSha":43,"skillDirectory":44,"forksCount":14,"repositoryHtmlUrl":45,"repositoryHomepageUrl":6,"ownerHtmlUrl":46,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":47,"install":48,"resources":61},"01M799Y6TSGPMQDX0HGD5F6TXZ","auto-animate",null,"AutoAnimate (@formkit\u002Fauto-animate) zero-config animations for React. Use for list transitions, accordions, toasts, or encountering SSR errors, animation libraries complexity.","Elogic360\u002Fsoftware-factory","Elogic360","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F156535519?v=4","01M74NH3F0RB13PWB7JZDE2V80","elogic360","01M74NH3FPC65082MDZVMFHDM3",0,"MIT","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: auto-animate\ndescription: \"AutoAnimate (@formkit\u002Fauto-animate) zero-config animations for React. Use for list transitions, accordions, toasts, or encountering SSR errors, animation libraries complexity.\"\n\nmetadata:\n  keywords:\n    - auto-animate\n    - \"@formkit\u002Fauto-animate\"\n    - formkit\n    - zero-config animation\n    - automatic animations\n    - drop-in animation\n    - list animations\n    - accordion animation\n    - toast animation\n    - form validation animation\n    - lightweight animation\n    - 2kb animation\n    - prefers-reduced-motion\n    - accessible animations\n    - vite react animation\n    - cloudflare workers animation\n    - ssr safe animation\n\nlicense: MIT\n---\n# AutoAnimate\n\n**Status**: Production Ready ✅\n**Last Updated**: 2025-11-07\n**Dependencies**: None (works with any React setup)\n**Latest Versions**: @formkit\u002Fauto-animate@0.9.0\n\n---\n\n## Quick Start (2 Minutes)\n\n### 1. Install AutoAnimate\n\n```bash\nbun add @formkit\u002Fauto-animate\n```\n\n**Why this matters:**\n- Only 3.28 KB gzipped (vs 22 KB for Motion)\n- Zero dependencies\n- Framework-agnostic (React, Vue, Svelte, vanilla JS)\n\n### 2. Add to Your Component\n\n```tsx\nimport { useAutoAnimate } from \"@formkit\u002Fauto-animate\u002Freact\";\n\nexport function MyList() {\n  const [parent] = useAutoAnimate(); \u002F\u002F 1. Get ref\n\n  return (\n    \u003Cul ref={parent}> {\u002F* 2. Attach to parent *\u002F}\n      {items.map(item => (\n        \u003Cli key={item.id}>{item.text}\u003C\u002Fli> {\u002F* 3. That's it! *\u002F}\n      ))}\n    \u003C\u002Ful>\n  );\n}\n```\n\n**CRITICAL:**\n- ✅ Always use unique, stable keys for list items\n- ✅ Parent element must always be rendered (not conditional)\n- ✅ AutoAnimate respects `prefers-reduced-motion` automatically\n- ✅ Works on add, remove, AND reorder operations\n\n### 3. Use in Production (SSR-Safe)\n\nFor Cloudflare Workers or Next.js:\n\n```tsx\n\u002F\u002F Use client-only import to prevent SSR errors\nimport { useState, useEffect } from \"react\";\n\nexport function useAutoAnimateSafe\u003CT extends HTMLElement>() {\n  const [parent, setParent] = useState\u003CT | null>(null);\n\n  useEffect(() => {\n    if (typeof window !== \"undefined\" && parent) {\n      import(\"@formkit\u002Fauto-animate\").then(({ default: autoAnimate }) => {\n        autoAnimate(parent);\n      });\n    }\n  }, [parent]);\n\n  return [parent, setParent] as const;\n}\n```\n\n---\n\n## Known Issues Prevention\n\nThis skill prevents **10+** documented issues:\n\n### Issue #1: SSR\u002FNext.js Import Errors\n**Error**: \"Can't import the named export 'useEffect' from non EcmaScript module\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F55\n**Why It Happens**: AutoAnimate uses DOM APIs not available on server\n**Prevention**: Use dynamic imports (see `templates\u002Fvite-ssr-safe.tsx`)\n\n### Issue #2: Conditional Parent Rendering\n**Error**: Animations don't work when parent is conditional\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F8\n**Why It Happens**: Ref can't attach to non-existent element\n**Prevention**:\n```tsx\n\u002F\u002F ❌ Wrong\n{showList && \u003Cul ref={parent}>...\u003C\u002Ful>}\n\n\u002F\u002F ✅ Correct\n\u003Cul ref={parent}>{showList && items.map(...)}\u003C\u002Ful>\n```\n\n### Issue #3: Missing Unique Keys\n**Error**: Items don't animate correctly or flash\n**Source**: Official docs\n**Why It Happens**: React can't track which items changed\n**Prevention**: Always use unique, stable keys (`key={item.id}`)\n\n### Issue #4: Flexbox Width Issues\n**Error**: Elements snap to width instead of animating smoothly\n**Source**: Official docs\n**Why It Happens**: `flex-grow: 1` waits for surrounding content\n**Prevention**: Use explicit width instead of flex-grow for animated elements\n\n### Issue #5: Table Row Display Issues\n**Error**: Table structure breaks when removing rows\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F7\n**Why It Happens**: Display: table-row conflicts with animations\n**Prevention**: Apply to `\u003Ctbody>` instead of individual rows, or use div-based layouts\n\n### Issue #6: Jest Testing Errors\n**Error**: \"Cannot find module '@formkit\u002Fauto-animate\u002Freact'\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F29\n**Why It Happens**: Jest doesn't resolve ESM exports correctly\n**Prevention**: Configure `moduleNameMapper` in jest.config.js\n\n### Issue #7: esbuild Compatibility\n**Error**: \"Path '.' not exported by package\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F36\n**Why It Happens**: ESM\u002FCommonJS condition mismatch\n**Prevention**: Configure esbuild to handle ESM modules properly\n\n### Issue #8: CSS Position Side Effects\n**Error**: Layout breaks after adding AutoAnimate\n**Source**: Official docs\n**Why It Happens**: Parent automatically gets `position: relative`\n**Prevention**: Account for position change in CSS or set explicitly\n\n### Issue #9: Vue\u002FNuxt Registration Errors\n**Error**: \"Failed to resolve directive: auto-animate\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F43\n**Why It Happens**: Plugin not registered correctly\n**Prevention**: Proper plugin setup in Vue\u002FNuxt config (see references\u002F)\n\n### Issue #10: Angular ESM Issues\n**Error**: Build fails with \"ESM-only package\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F72\n**Why It Happens**: CommonJS build environment\n**Prevention**: Configure ng-packagr for Angular Package Format\n\n---\n\n## When to Use AutoAnimate vs Motion\n\n### Use AutoAnimate When:\n- ✅ Simple list transitions (add\u002Fremove\u002Fsort)\n- ✅ Accordion expand\u002Fcollapse\n- ✅ Toast notifications fade in\u002Fout\n- ✅ Form validation messages appear\u002Fdisappear\n- ✅ Zero configuration preferred\n- ✅ Small bundle size critical (3.28 KB)\n- ✅ Applying to existing\u002F3rd-party code\n- ✅ \"Good enough\" animations acceptable\n\n### Use Motion When:\n- ✅ Complex choreographed animations\n- ✅ Gesture controls (drag, swipe, hover)\n- ✅ Scroll-based animations\n- ✅ Spring physics animations\n- ✅ SVG path animations\n- ✅ Keyframe control needed\n- ✅ Animation variants\u002Forchestration\n- ✅ Custom easing curves\n\n**Rule of Thumb**: Use AutoAnimate for 90% of cases, Motion for hero\u002Finteractive animations.\n\n---\n\n## Critical Rules\n\n### Always Do\n\n✅ **Use unique, stable keys** - `key={item.id}` not `key={index}`\n✅ **Keep parent in DOM** - Parent ref element always rendered\n✅ **Client-only for SSR** - Dynamic import for server environments\n✅ **Respect accessibility** - Keep `disrespectUserMotionPreference: false`\n✅ **Test with motion disabled** - Verify UI works without animations\n✅ **Use explicit width** - Avoid flex-grow on animated elements\n✅ **Apply to tbody for tables** - Not individual rows\n\n### Never Do\n\n❌ **Conditional parent** - `{show && \u003Cul ref={parent}>}`\n❌ **Index as key** - `key={index}` breaks animations\n❌ **Ignore SSR** - Will break in Cloudflare Workers\u002FNext.js\n❌ **Force animations** - `disrespectUserMotionPreference: true` breaks accessibility\n❌ **Animate tables directly** - Use tbody or div-based layout\n❌ **Skip unique keys** - Required for proper animation\n❌ **Complex animations** - Use Motion instead\n\n---\n\n## Configuration\n\nAutoAnimate is zero-config by default. Optional customization:\n\n```tsx\nimport { useAutoAnimate } from \"@formkit\u002Fauto-animate\u002Freact\";\n\nconst [parent] = useAutoAnimate({\n  duration: 250, \u002F\u002F milliseconds (default: 250)\n  easing: \"ease-in-out\", \u002F\u002F CSS easing (default: \"ease-in-out\")\n  \u002F\u002F disrespectUserMotionPreference: false, \u002F\u002F Keep false!\n});\n```\n\n**Recommendation**: Use defaults unless you have specific design requirements.\n\n---\n\n## Using Bundled Resources\n\n### Templates (templates\u002F)\n\nCopy-paste ready examples:\n\n- `react-basic.tsx` - Simple list with add\u002Fremove\u002Fshuffle\n- `react-typescript.tsx` - Typed setup with custom config\n- `filter-sort-list.tsx` - Animated filtering and sorting\n- `accordion.tsx` - Expandable sections\n- `toast-notifications.tsx` - Fade in\u002Fout messages\n- `form-validation.tsx` - Error messages animation\n- `vite-ssr-safe.tsx` - Cloudflare Workers\u002FSSR pattern\n\n### References (references\u002F)\n\n- `auto-animate-vs-motion.md` - Decision guide for which to use\n- `css-conflicts.md` - Flexbox, table, and position gotchas\n- `ssr-patterns.md` - Next.js, Nuxt, Workers workarounds\n\n### Scripts (scripts\u002F)\n\n- `init-auto-animate.sh` - Automated setup script\n\n---\n\n## Cloudflare Workers Compatibility\n\nAutoAnimate works perfectly with Cloudflare Workers Static Assets:\n\n✅ **Client-side only** - Runs in browser, not Worker runtime\n✅ **No Node.js deps** - Pure browser code\n✅ **Edge-friendly** - 3.28 KB gzipped\n✅ **SSR-safe** - Use dynamic imports (see templates\u002F)\n\n**Vite Config**:\n```typescript\nexport default defineConfig({\n  plugins: [react(), cloudflare()],\n  ssr: {\n    external: [\"@formkit\u002Fauto-animate\"],\n  },\n});\n```\n\n---\n\n## Accessibility\n\nAutoAnimate respects `prefers-reduced-motion` **automatically**:\n\n```css\n\u002F* User's system preference *\u002F\n@media (prefers-reduced-motion: reduce) {\n  \u002F* AutoAnimate disables animations automatically *\u002F\n}\n```\n\n**Critical**: Never set `disrespectUserMotionPreference: true` - this breaks accessibility.\n\n---\n\n## Official Documentation\n\n- **Official Site**: https:\u002F\u002Fauto-animate.formkit.com\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\n- **npm**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@formkit\u002Fauto-animate\n- **React Docs**: https:\u002F\u002Fauto-animate.formkit.com\u002Freact\n- **Video Tutorial**: Laracasts video (see README)\n\n---\n\n## Package Versions (Verified 2025-11-07)\n\n```json\n{\n  \"dependencies\": {\n    \"@formkit\u002Fauto-animate\": \"^0.9.0\"\n  },\n  \"devDependencies\": {\n    \"react\": \"^19.2.0\",\n    \"vite\": \"^6.0.0\"\n  }\n}\n```\n\n---\n\n## Production Example\n\nThis skill is based on production testing:\n\n- **Bundle Size**: 3.28 KB gzipped\n- **Setup Time**: 2 minutes (vs 15 min with Motion)\n- **Errors**: 0 (all 10 known issues prevented)\n- **Validation**: ✅ Works with Vite, Tailwind v4, Cloudflare Workers, React 19\n\n**Tested Scenarios:**\n- ✅ Filter\u002Fsort lists\n- ✅ Accordion components\n- ✅ Toast notifications\n- ✅ Form validation messages\n- ✅ SSR\u002FCloudflare Workers\n- ✅ Accessibility (prefers-reduced-motion)\n\n---\n\n## Troubleshooting\n\n### Problem: Animations not working\n**Solution**: Check these common issues:\n1. Is parent element always in DOM? (not conditional)\n2. Do items have unique, stable keys?\n3. Is ref attached to immediate parent of animated children?\n\n### Problem: SSR\u002FNext.js errors\n**Solution**: Use dynamic import:\n```tsx\nuseEffect(() => {\n  if (typeof window !== \"undefined\") {\n    import(\"@formkit\u002Fauto-animate\").then(({ default: autoAnimate }) => {\n      autoAnimate(parent);\n    });\n  }\n}, [parent]);\n```\n\n### Problem: Items flash instead of animating\n**Solution**: Add unique keys: `key={item.id}` not `key={index}`\n\n### Problem: Flexbox width issues\n**Solution**: Use explicit width instead of `flex-grow: 1`\n\n### Problem: Table rows don't animate\n**Solution**: Apply ref to `\u003Ctbody>`, not individual `\u003Ctr>` elements\n\n---\n\n## Complete Setup Checklist\n\n- [ ] Installed `@formkit\u002Fauto-animate@0.9.0`\n- [ ] Using React 19+ (or Vue\u002FSvelte)\n- [ ] Added ref to parent element\n- [ ] Parent element always rendered (not conditional)\n- [ ] List items have unique, stable keys\n- [ ] Tested with `prefers-reduced-motion`\n- [ ] SSR-safe if using Cloudflare Workers\u002FNext.js\n- [ ] No flexbox width issues\n- [ ] Dev server runs without errors\n- [ ] Production build succeeds\n\n---\n\n**Questions? Issues?**\n\n1. Check `templates\u002F` for working examples\n2. Check `references\u002Fauto-animate-vs-motion.md` for library comparison\n3. Check `references\u002Fssr-patterns.md` for SSR workarounds\n4. Check official docs: https:\u002F\u002Fauto-animate.formkit.com\n5. Check GitHub issues: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\n\n---\n\n**Production Ready?** ✅ Yes - 13.6k stars, actively maintained, zero dependencies.\n","# AutoAnimate\n\n**Status**: Production Ready ✅\n**Last Updated**: 2025-11-07\n**Dependencies**: None (works with any React setup)\n**Latest Versions**: @formkit\u002Fauto-animate@0.9.0\n\n---\n\n## Quick Start (2 Minutes)\n\n### 1. Install AutoAnimate\n\n```bash\nbun add @formkit\u002Fauto-animate\n```\n\n**Why this matters:**\n- Only 3.28 KB gzipped (vs 22 KB for Motion)\n- Zero dependencies\n- Framework-agnostic (React, Vue, Svelte, vanilla JS)\n\n### 2. Add to Your Component\n\n```tsx\nimport { useAutoAnimate } from \"@formkit\u002Fauto-animate\u002Freact\";\n\nexport function MyList() {\n  const [parent] = useAutoAnimate(); \u002F\u002F 1. Get ref\n\n  return (\n    \u003Cul ref={parent}> {\u002F* 2. Attach to parent *\u002F}\n      {items.map(item => (\n        \u003Cli key={item.id}>{item.text}\u003C\u002Fli> {\u002F* 3. That's it! *\u002F}\n      ))}\n    \u003C\u002Ful>\n  );\n}\n```\n\n**CRITICAL:**\n- ✅ Always use unique, stable keys for list items\n- ✅ Parent element must always be rendered (not conditional)\n- ✅ AutoAnimate respects `prefers-reduced-motion` automatically\n- ✅ Works on add, remove, AND reorder operations\n\n### 3. Use in Production (SSR-Safe)\n\nFor Cloudflare Workers or Next.js:\n\n```tsx\n\u002F\u002F Use client-only import to prevent SSR errors\nimport { useState, useEffect } from \"react\";\n\nexport function useAutoAnimateSafe\u003CT extends HTMLElement>() {\n  const [parent, setParent] = useState\u003CT | null>(null);\n\n  useEffect(() => {\n    if (typeof window !== \"undefined\" && parent) {\n      import(\"@formkit\u002Fauto-animate\").then(({ default: autoAnimate }) => {\n        autoAnimate(parent);\n      });\n    }\n  }, [parent]);\n\n  return [parent, setParent] as const;\n}\n```\n\n---\n\n## Known Issues Prevention\n\nThis skill prevents **10+** documented issues:\n\n### Issue #1: SSR\u002FNext.js Import Errors\n**Error**: \"Can't import the named export 'useEffect' from non EcmaScript module\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F55\n**Why It Happens**: AutoAnimate uses DOM APIs not available on server\n**Prevention**: Use dynamic imports (see `templates\u002Fvite-ssr-safe.tsx`)\n\n### Issue #2: Conditional Parent Rendering\n**Error**: Animations don't work when parent is conditional\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F8\n**Why It Happens**: Ref can't attach to non-existent element\n**Prevention**:\n```tsx\n\u002F\u002F ❌ Wrong\n{showList && \u003Cul ref={parent}>...\u003C\u002Ful>}\n\n\u002F\u002F ✅ Correct\n\u003Cul ref={parent}>{showList && items.map(...)}\u003C\u002Ful>\n```\n\n### Issue #3: Missing Unique Keys\n**Error**: Items don't animate correctly or flash\n**Source**: Official docs\n**Why It Happens**: React can't track which items changed\n**Prevention**: Always use unique, stable keys (`key={item.id}`)\n\n### Issue #4: Flexbox Width Issues\n**Error**: Elements snap to width instead of animating smoothly\n**Source**: Official docs\n**Why It Happens**: `flex-grow: 1` waits for surrounding content\n**Prevention**: Use explicit width instead of flex-grow for animated elements\n\n### Issue #5: Table Row Display Issues\n**Error**: Table structure breaks when removing rows\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F7\n**Why It Happens**: Display: table-row conflicts with animations\n**Prevention**: Apply to `\u003Ctbody>` instead of individual rows, or use div-based layouts\n\n### Issue #6: Jest Testing Errors\n**Error**: \"Cannot find module '@formkit\u002Fauto-animate\u002Freact'\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F29\n**Why It Happens**: Jest doesn't resolve ESM exports correctly\n**Prevention**: Configure `moduleNameMapper` in jest.config.js\n\n### Issue #7: esbuild Compatibility\n**Error**: \"Path '.' not exported by package\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F36\n**Why It Happens**: ESM\u002FCommonJS condition mismatch\n**Prevention**: Configure esbuild to handle ESM modules properly\n\n### Issue #8: CSS Position Side Effects\n**Error**: Layout breaks after adding AutoAnimate\n**Source**: Official docs\n**Why It Happens**: Parent automatically gets `position: relative`\n**Prevention**: Account for position change in CSS or set explicitly\n\n### Issue #9: Vue\u002FNuxt Registration Errors\n**Error**: \"Failed to resolve directive: auto-animate\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F43\n**Why It Happens**: Plugin not registered correctly\n**Prevention**: Proper plugin setup in Vue\u002FNuxt config (see references\u002F)\n\n### Issue #10: Angular ESM Issues\n**Error**: Build fails with \"ESM-only package\"\n**Source**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\u002F72\n**Why It Happens**: CommonJS build environment\n**Prevention**: Configure ng-packagr for Angular Package Format\n\n---\n\n## When to Use AutoAnimate vs Motion\n\n### Use AutoAnimate When:\n- ✅ Simple list transitions (add\u002Fremove\u002Fsort)\n- ✅ Accordion expand\u002Fcollapse\n- ✅ Toast notifications fade in\u002Fout\n- ✅ Form validation messages appear\u002Fdisappear\n- ✅ Zero configuration preferred\n- ✅ Small bundle size critical (3.28 KB)\n- ✅ Applying to existing\u002F3rd-party code\n- ✅ \"Good enough\" animations acceptable\n\n### Use Motion When:\n- ✅ Complex choreographed animations\n- ✅ Gesture controls (drag, swipe, hover)\n- ✅ Scroll-based animations\n- ✅ Spring physics animations\n- ✅ SVG path animations\n- ✅ Keyframe control needed\n- ✅ Animation variants\u002Forchestration\n- ✅ Custom easing curves\n\n**Rule of Thumb**: Use AutoAnimate for 90% of cases, Motion for hero\u002Finteractive animations.\n\n---\n\n## Critical Rules\n\n### Always Do\n\n✅ **Use unique, stable keys** - `key={item.id}` not `key={index}`\n✅ **Keep parent in DOM** - Parent ref element always rendered\n✅ **Client-only for SSR** - Dynamic import for server environments\n✅ **Respect accessibility** - Keep `disrespectUserMotionPreference: false`\n✅ **Test with motion disabled** - Verify UI works without animations\n✅ **Use explicit width** - Avoid flex-grow on animated elements\n✅ **Apply to tbody for tables** - Not individual rows\n\n### Never Do\n\n❌ **Conditional parent** - `{show && \u003Cul ref={parent}>}`\n❌ **Index as key** - `key={index}` breaks animations\n❌ **Ignore SSR** - Will break in Cloudflare Workers\u002FNext.js\n❌ **Force animations** - `disrespectUserMotionPreference: true` breaks accessibility\n❌ **Animate tables directly** - Use tbody or div-based layout\n❌ **Skip unique keys** - Required for proper animation\n❌ **Complex animations** - Use Motion instead\n\n---\n\n## Configuration\n\nAutoAnimate is zero-config by default. Optional customization:\n\n```tsx\nimport { useAutoAnimate } from \"@formkit\u002Fauto-animate\u002Freact\";\n\nconst [parent] = useAutoAnimate({\n  duration: 250, \u002F\u002F milliseconds (default: 250)\n  easing: \"ease-in-out\", \u002F\u002F CSS easing (default: \"ease-in-out\")\n  \u002F\u002F disrespectUserMotionPreference: false, \u002F\u002F Keep false!\n});\n```\n\n**Recommendation**: Use defaults unless you have specific design requirements.\n\n---\n\n## Using Bundled Resources\n\n### Templates (templates\u002F)\n\nCopy-paste ready examples:\n\n- `react-basic.tsx` - Simple list with add\u002Fremove\u002Fshuffle\n- `react-typescript.tsx` - Typed setup with custom config\n- `filter-sort-list.tsx` - Animated filtering and sorting\n- `accordion.tsx` - Expandable sections\n- `toast-notifications.tsx` - Fade in\u002Fout messages\n- `form-validation.tsx` - Error messages animation\n- `vite-ssr-safe.tsx` - Cloudflare Workers\u002FSSR pattern\n\n### References (references\u002F)\n\n- `auto-animate-vs-motion.md` - Decision guide for which to use\n- `css-conflicts.md` - Flexbox, table, and position gotchas\n- `ssr-patterns.md` - Next.js, Nuxt, Workers workarounds\n\n### Scripts (scripts\u002F)\n\n- `init-auto-animate.sh` - Automated setup script\n\n---\n\n## Cloudflare Workers Compatibility\n\nAutoAnimate works perfectly with Cloudflare Workers Static Assets:\n\n✅ **Client-side only** - Runs in browser, not Worker runtime\n✅ **No Node.js deps** - Pure browser code\n✅ **Edge-friendly** - 3.28 KB gzipped\n✅ **SSR-safe** - Use dynamic imports (see templates\u002F)\n\n**Vite Config**:\n```typescript\nexport default defineConfig({\n  plugins: [react(), cloudflare()],\n  ssr: {\n    external: [\"@formkit\u002Fauto-animate\"],\n  },\n});\n```\n\n---\n\n## Accessibility\n\nAutoAnimate respects `prefers-reduced-motion` **automatically**:\n\n```css\n\u002F* User's system preference *\u002F\n@media (prefers-reduced-motion: reduce) {\n  \u002F* AutoAnimate disables animations automatically *\u002F\n}\n```\n\n**Critical**: Never set `disrespectUserMotionPreference: true` - this breaks accessibility.\n\n---\n\n## Official Documentation\n\n- **Official Site**: https:\u002F\u002Fauto-animate.formkit.com\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\n- **npm**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@formkit\u002Fauto-animate\n- **React Docs**: https:\u002F\u002Fauto-animate.formkit.com\u002Freact\n- **Video Tutorial**: Laracasts video (see README)\n\n---\n\n## Package Versions (Verified 2025-11-07)\n\n```json\n{\n  \"dependencies\": {\n    \"@formkit\u002Fauto-animate\": \"^0.9.0\"\n  },\n  \"devDependencies\": {\n    \"react\": \"^19.2.0\",\n    \"vite\": \"^6.0.0\"\n  }\n}\n```\n\n---\n\n## Production Example\n\nThis skill is based on production testing:\n\n- **Bundle Size**: 3.28 KB gzipped\n- **Setup Time**: 2 minutes (vs 15 min with Motion)\n- **Errors**: 0 (all 10 known issues prevented)\n- **Validation**: ✅ Works with Vite, Tailwind v4, Cloudflare Workers, React 19\n\n**Tested Scenarios:**\n- ✅ Filter\u002Fsort lists\n- ✅ Accordion components\n- ✅ Toast notifications\n- ✅ Form validation messages\n- ✅ SSR\u002FCloudflare Workers\n- ✅ Accessibility (prefers-reduced-motion)\n\n---\n\n## Troubleshooting\n\n### Problem: Animations not working\n**Solution**: Check these common issues:\n1. Is parent element always in DOM? (not conditional)\n2. Do items have unique, stable keys?\n3. Is ref attached to immediate parent of animated children?\n\n### Problem: SSR\u002FNext.js errors\n**Solution**: Use dynamic import:\n```tsx\nuseEffect(() => {\n  if (typeof window !== \"undefined\") {\n    import(\"@formkit\u002Fauto-animate\").then(({ default: autoAnimate }) => {\n      autoAnimate(parent);\n    });\n  }\n}, [parent]);\n```\n\n### Problem: Items flash instead of animating\n**Solution**: Add unique keys: `key={item.id}` not `key={index}`\n\n### Problem: Flexbox width issues\n**Solution**: Use explicit width instead of `flex-grow: 1`\n\n### Problem: Table rows don't animate\n**Solution**: Apply ref to `\u003Ctbody>`, not individual `\u003Ctr>` elements\n\n---\n\n## Complete Setup Checklist\n\n- [ ] Installed `@formkit\u002Fauto-animate@0.9.0`\n- [ ] Using React 19+ (or Vue\u002FSvelte)\n- [ ] Added ref to parent element\n- [ ] Parent element always rendered (not conditional)\n- [ ] List items have unique, stable keys\n- [ ] Tested with `prefers-reduced-motion`\n- [ ] SSR-safe if using Cloudflare Workers\u002FNext.js\n- [ ] No flexbox width issues\n- [ ] Dev server runs without errors\n- [ ] Production build succeeds\n\n---\n\n**Questions? Issues?**\n\n1. Check `templates\u002F` for working examples\n2. Check `references\u002Fauto-animate-vs-motion.md` for library comparison\n3. Check `references\u002Fssr-patterns.md` for SSR workarounds\n4. Check official docs: https:\u002F\u002Fauto-animate.formkit.com\n5. Check GitHub issues: https:\u002F\u002Fgithub.com\u002Fformkit\u002Fauto-animate\u002Fissues\n\n---\n\n**Production Ready?** ✅ Yes - 13.6k stars, actively maintained, zero dependencies.\n",{"name":5,"license":15,"metadata":24,"description":7},{"keywords":25},[5,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41],"@formkit\u002Fauto-animate","formkit","zero-config animation","automatic animations","drop-in animation","list animations","accordion animation","toast animation","form validation animation","lightweight animation","2kb animation","prefers-reduced-motion","accessible animations","vite react animation","cloudflare workers animation","ssr safe animation","main","c475fc64e94e803b50d14a791dfee8853fbb2c5c","integrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory","https:\u002F\u002Fgithub.com\u002FElogic360","2026-11-08 22:21:22",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add Elogic360\u002Fsoftware-factory --skill auto-animate",{"tool":54,"command":55},"bunx","bunx skills add Elogic360\u002Fsoftware-factory --skill auto-animate",{"tool":57,"command":58},"pnpm","pnpm dlx skills add Elogic360\u002Fsoftware-factory --skill auto-animate","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002FSKILL.md",true,[62,68,74,78,82,86,92,96,102,106,110,114,118,122],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"assets\u002Fexample-template.txt","ASSET","资产文件",416,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Fassets\u002Fexample-template.txt",{"path":69,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Fauto-animate-vs-motion.md","REFERENCE","参考文档",10084,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Freferences\u002Fauto-animate-vs-motion.md",{"path":75,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Fcss-conflicts.md",13308,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Freferences\u002Fcss-conflicts.md",{"path":79,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fexample-reference.md",760,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Freferences\u002Fexample-reference.md",{"path":83,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Fssr-patterns.md",12731,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Freferences\u002Fssr-patterns.md",{"path":87,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":90,"sourceHtmlUrl":91},"scripts\u002Fexample-script.sh","SCRIPT","脚本",302,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Fscripts\u002Fexample-script.sh",{"path":93,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":94,"sourceHtmlUrl":95},"scripts\u002Finit-auto-animate.sh",8719,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Fscripts\u002Finit-auto-animate.sh",{"path":97,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":100,"sourceHtmlUrl":101},"templates\u002Faccordion.tsx","OTHER","其他",2803,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Ftemplates\u002Faccordion.tsx",{"path":103,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":104,"sourceHtmlUrl":105},"templates\u002Ffilter-sort-list.tsx",3263,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Ftemplates\u002Ffilter-sort-list.tsx",{"path":107,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":108,"sourceHtmlUrl":109},"templates\u002Fform-validation.tsx",4275,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Ftemplates\u002Fform-validation.tsx",{"path":111,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":112,"sourceHtmlUrl":113},"templates\u002Freact-basic.tsx",2876,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Ftemplates\u002Freact-basic.tsx",{"path":115,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":116,"sourceHtmlUrl":117},"templates\u002Freact-typescript.tsx",4825,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Ftemplates\u002Freact-typescript.tsx",{"path":119,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":120,"sourceHtmlUrl":121},"templates\u002Ftoast-notifications.tsx",1898,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Ftemplates\u002Ftoast-notifications.tsx",{"path":123,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":124,"sourceHtmlUrl":125},"templates\u002Fvite-ssr-safe.tsx",4346,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fauto-animate\u002Fskills\u002Fauto-animate\u002Ftemplates\u002Fvite-ssr-safe.tsx",[127,135,142,149,156,163],{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":131,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":19},"01M79G206MT3J6S0GY3C45P2KV","vss-summarize-video","Use to summarize a recorded video via the LVS summarization microservice (HITL-gated) with a VLM fallback. Not for report generation or live RTSP captioning.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-summarize-video\u002FSKILL.md",[],[],{"skillNo":136,"name":137,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":131,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":141,"publishedAt":19},"01M79G1WN63PGRE8CKD47WEBQ5","vss-setup-video-analytics-api","Use to deploy the vss-video-analytics-api REST service standalone (config-source, data-log bind, Elasticsearch, optional Kafka). Not for full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-video-analytics-api\u002FSKILL.md",[],[],{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":131,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":148,"publishedAt":19},"01M79G1S9F7VY3EF6H53PRP5AN","vss-setup-behavior-analytics","Use to deploy the vss-behavior-analytics service standalone (entrypoint, config-source, optional calibration). Not for the full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-behavior-analytics\u002FSKILL.md",[],[],{"skillNo":150,"name":151,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":131,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":155,"publishedAt":19},"01M79G1N1S1Y27PFZPYMNK1MTQ","vss-search-archive","Use this skill to run top-level VSS fusion search on archived video, or to ingest video files \u002F RTSP streams for search. Do NOT use for ad-hoc visual Q&A (use vss-ask-video), live captioning (use vss-deploy-dense-captioning), or video summarization and reports (use vss-summarize-video).","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-search-archive\u002FSKILL.md",[],[],{"skillNo":157,"name":158,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":131,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":19},"01M79G1H6WN0Q6C0VCAXCZX6B7","vss-query-analytics","Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-query-analytics\u002FSKILL.md",[],[],{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":131,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":19},"01M79G1DYPNXQS7QHZ0AAF5FX5","vss-manage-video-io-storage","Use to call the VIOS REST API (sensor list, timelines, clip extraction, snapshots, add\u002Fdelete sensors and streams). Not for VLM inference or search.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-manage-video-io-storage\u002FSKILL.md",[],[]]