К основному содержанию
скилл CX Codex

motion · oakoss — скилл для Claude Code: что делает и как установить

Скилл обучает ИИ-агента правильно применять библиотеку Motion (framer-motion) в React и Next.js. Помогает настроить жесты, скролл-эффекты и избежать просадок FPS.

MIT 176 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill motion -a claude-code
Открыть на GitHub

Что делает motion

Скилл даёт агенту правила работы с библиотекой motion (ранее framer-motion) для React 18.2+, React 19 и Next.js App Router. Он ориентирует модель на правильные импорты из motion/react вместо устаревших пакетов. Агент узнаёт проверенные паттерны для жестов перетаскивания, отрисовки SVG через pathLength, задержек в списках и переходов страниц через AnimatePresence.

Внутри описаны схемы гибридного движка: WAAPI для сдвигов и прозрачности, а также ScrollTimeline для эффектов прокрутки. Полный бандл весит 34 KB. Чтобы не раздувать сборку, скилл предлагает ужимать её до 4.6 KB связкой LazyMotion и domAnimation или брать хук useAnimate на 2.3 KB. Прямое изменение width или height блокируется правилом в пользу свойства layout и аппаратного ускорения через GPU.

Конфликт классов Tailwind transition-* с анимациями Motion приводит к рывкам кадров, поэтому скилл требует их убирать. Для простого добавления элементов в список инструмент избыточен: вместо него рекомендуется легковесный AutoAnimate на 3.28 KB.

Какие задачи решает

  • настроить плавное удаление компонентов через AnimatePresence с уникальными ключами
  • уменьшить размер бандла анимаций до 4.6 KB с помощью LazyMotion
  • создать эффект параллакса и индикатор прокрутки через useScroll
  • устранить конфликты между классами переходов Tailwind и свойствами Motion

Примеры запросов агенту

  • Сделай модальное окно на Next.js с плавной анимацией закрытия через AnimatePresence и motion/react.
  • Настрой индикатор чтения статьи с привязкой к useScroll и scaleX.
  • Оптимизируй анимацию карточек в каталоге, подключив LazyMotion вместо полного бандла.

Как установить motion

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill motion -a claude-code

2Вручную: положить файлы

~/.claude/skills/motion/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/motion/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о motion

Как установить motion в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill motion -a claude-code в терминале.

Для каких задач скилл не рекомендует использовать Motion?

Для 3D-графики автор советует применять Three.js или React Three Fiber. Для базовой вставки и удаления элементов из списков лучше взять AutoAnimate весом 3.28 KB.

Как скилл решает проблему с размером бандла?

Полный пакет весит 34 KB, поэтому скилл переводит проект на компонент m с LazyMotion и domAnimation, что снижает размер до 4.6 KB, либо использует хук useAnimate на 2.3 KB.

Исходный текст

SKILL.md · MIT
---
name: motion
description: |
  Web animations with Motion (formerly Framer Motion) for React -- gestures, scroll effects, spring physics, layout animations, SVG, micro-interactions, loading states.

  Use when: drag-and-drop, scroll animations, modals, carousels, parallax, page transitions, hover effects, staggered lists, loading spinners, number counters.
  Troubleshoot: AnimatePresence exit, list performance, Tailwind conflicts, Next.js "use client", layout in scaled containers.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://motion.dev/docs'
user-invocable: false
---

# Motion

## Overview

Motion (package: `motion`, formerly `framer-motion`) is the standard React animation library. Import from `motion/react`. Provides declarative props for gestures, scroll-linked animations, layout transitions, SVG path drawing, and spring physics. Uses a hybrid animation engine (WAAPI for transforms/opacity, ScrollTimeline for scroll-linked effects). Bundle ranges from 2.3 KB (useAnimate mini) to 34 KB (full), optimizable to 4.6 KB with LazyMotion. Compatible with React 18.2+, React 19, Next.js App Router, and Vite.

Do NOT use Motion for simple list add/remove animations (use AutoAnimate instead at 3.28 KB). Do NOT use for 3D (use Three.js / React Three Fiber).

## Quick Reference

| Pattern                | API / Props                                             |
| ---------------------- | ------------------------------------------------------- |
| Fade in on mount       | `initial`, `animate`, `transition`                      |
| Exit animations        | `AnimatePresence` + `exit` prop (unique `key` required) |
| Staggered list         | `variants` with `staggerChildren`                       |
| Hover / tap / focus    | `whileHover`, `whileTap`, `whileFocus`                  |
| Drag                   | `drag`, `dragConstraints`, `dragElastic`                |
| Scroll-triggered       | `whileInView`, `viewport={{ once: true }}`              |
| Scroll-linked/parallax | `useScroll` + `useTransform`                            |
| Progress indicator     | `scrollYProgress` + `scaleX`                            |
| Layout animation       | `layout` prop (FLIP technique)                          |
| Shared element         | `layoutId` (same ID across views)                       |
| Layout group           | `LayoutGroup` wrapping sibling lists                    |
| Page transition        | `AnimatePresence` + `key={pathname}`                    |
| SVG path drawing       | `pathLength` on `motion.path`                           |
| Animated counter       | `useSpring` + `useTransform`                            |
| Imperative control     | `useAnimate` hook returns `[scope, animate]`            |
| Custom components      | `motion.create(Component)` wraps any component          |
| Bundle optimization    | `LazyMotion` + `domAnimation` + `m` component (4.6 KB)  |
| Reduced motion         | `MotionConfig reducedMotion="user"`                     |

## Common Mistakes

| Mistake                                                   | Correct Pattern                                                   |
| --------------------------------------------------------- | ----------------------------------------------------------------- |
| AnimatePresence inside a conditional                      | Keep AnimatePresence mounted; place conditional content inside it |
| Missing unique `key` on AnimatePresence children          | Add unique `key` to each direct child for exit animations         |
| Tailwind `transition-*` classes with Motion animate props | Remove Tailwind transition classes to avoid stuttering            |
| Importing from `framer-motion`                            | Use `import { motion } from "motion/react"` (renamed late 2024)   |
| Animating 50+ items without virtualization                | Use react-window or @tanstack/react-virtual for large lists       |
| Full 34 KB bundle for simple animations                   | Use LazyMotion + domAnimation (4.6 KB) or useAnimate (2.3 KB)     |
| Missing `"use client"` in Next.js App Router              | Add directive or use `motion/react-client` import                 |
| Animating `width`/`height` directly                       | Use `layout` prop or `transform: scale` for GPU acceleration      |
| No `prefers-reduced-motion` handling                      | Wrap app in `MotionConfig reducedMotion="user"`                   |

## Delegation

- **Audit animation performance and bundle size**: Use `Explore` agent to find heavy imports, missing LazyMotion, and reflow-triggering properties
- **Build complex multi-step animations**: Use `Task` agent for scroll-linked parallax, shared layout transitions, and staggered sequences
- **Plan animation architecture for a new project**: Use `Plan` agent to evaluate Motion vs AutoAnimate vs CSS-only based on requirements

> If the `design-system` skill is available, delegate animation token definitions and motion design guidelines to it.

## References

- [Core Patterns](references/core-patterns.md) -- Animation patterns: fade, exit, stagger, gestures, modal, accordion, tabs, scroll, layout, drag, SVG, loading
- [Scroll Animations](references/scroll-animations.md) -- useScroll, useTransform, scroll-triggered, parallax, progress indicators, offset configuration
- [Performance](references/performance.md) -- LazyMotion, useAnimate, hardware acceleration, virtualization, production checklist
- [Next.js Integration](references/nextjs-integration.md) -- App Router patterns, motion/react-client, Pages Router, known issues
- [Accessibility & CSS](references/accessibility-css.md) -- prefers-reduced-motion, MotionConfig, useReducedMotion, CSS keyframes, Tailwind animations
- [Library Selection Guide](references/library-selection.md) -- Motion vs AutoAnimate decision guide with feature comparison and use-case recommendations
- [Troubleshooting](references/troubleshooting.md) -- AnimatePresence bugs, Tailwind conflicts, layout glitches, React 19 issues, naming migration

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — motion от других авторов.

motion motiondivision Скилл помогает создавать анимации для веб-интерфейсов, искать примеры Motion и разбирать проблемы с производительностью. Пригодится и для CSS-анимаций, и для проектов на React или Vue. CX Codex +1 1 400установок motion secondsky Подключает библиотеку Motion (Framer Motion) — drag-and-drop, скролл-анимации, жесты, морфинг SVG, физику пружин. CX Codex +1 1 100установок motion Mindrally Задаёт агенту правила работы с библиотекой Motion в чистом JavaScript и TypeScript. Помогает писать быстрые веб-анимации на GPU без просадок кадров. CX Codex +1 861установок motion raphaelsalaja Скилл motion для Claude Code задаёт правила анимации интерфейсов: переходы, жесты, длительность и размытие. Помогает настроить движение элементов и проверить его поведение при взаимодействии. CX Codex +1 259установок nextjs-framer-motion-animations tristanmanchester Скилл nextjs-framer-motion-animations помогает агенту внедрять и отлаживать Motion for React в Next.js: жесты, выходы, layout, общие элементы, скролл и переходы между маршрутами. CX Codex +1 183установок motion-framer freshtechbro Скилл motion-framer помогает агенту добавлять анимации Motion и Framer Motion в React-интерфейсы: от эффектов наведения до переходов между состояниями. CX Codex +1 6 800установок framer-motion AThevon Подсказывает агенту правила работы с Framer Motion и Motion в React: анимации раскладки, жесты и хуки без лишних ререндеров. CX Codex +1 1 000установок framer-motion-animator patricio0312rev Скилл framer-motion-animator помогает создавать анимации и микроинтерфейсы на Framer Motion: от переходов между страницами до жестов свайпа и скролла. Пригодится при вёрстке интерактивных React-компонентов. CX Codex +1 11 700установок motion-patterns jeff Скилл motion-patterns для Claude Code добавляет готовые паттерны анимации для React и Next.js. Оформляет кнопки, модальные окна, toast, переходы страниц и scroll-reveal. CX Codex +1 6 500установок motion-dev-animations Motion Dev Standards Скилл motion-dev-animations генерирует GPU-анимации на Motion.dev для React, Next.js, Svelte и Astro. Помогает настроить физику пружин, скролл-эффекты и жесты с учётом prefers-reduced-motion. CX Codex +1 714установок

Из того же набора106

Весь набор →
ssh-remote Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок tanstack-hotkeys Скилл для агента: подсказывает, как собрать горячие клавиши в React на TanStack Hotkeys — от одиночных комбинаций до записи пользовательских шорткатов. CX Codex +1 179установок technical-docs Скилл technical-docs для Claude Code помогает писать и обновлять техническую документацию, строить диаграммы Mermaid и сверять документацию с кодом. Помогает вести doc-as-code и проверять покрытие. CX Codex +1 177установок mermaid-diagrams Скилл mermaid-diagrams помогает создавать Mermaid-диаграммы в Markdown: от блок-схем и ERD до графиков, mindmap и архитектурных схем. CX Codex +1 177установок shadcn-ui Учит агента работать с shadcn/ui: добавлять компоненты через CLI, настраивать темы на oklch и собирать формы с проверкой через Zod. CX Codex +1 176установок local-first Скилл local-first помогает решить, нужна ли веб-приложению локальная база с синхронизацией, и выбрать движок и стратегию разрешения конфликтов. CX Codex +1 173установок tanstack-query Помогает агенту писать запросы и мутации на TanStack Query v5, переводить код с v4 и настраивать инвалидацию кэша. CX Codex +1 170установок threejs Помогает создавать 3D-сцены на Three.js, подключать WebGPU и React Three Fiber. Помогает настраивать шейдеры, загружать модели и повышать производительность. CX Codex +1 167установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой