motion-v-skilld — скилл для Claude Code: Motion для Vue
Скилл motion-v-skilld для анимаций через motion-v (Motion для Vue) — компонент motion, жесты, варианты, директива v-motion, Nuxt-модуль.
MIT 146 установок ★ 186 обновлён 2026-10-10
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a claude-codeЧто делает motion-v-skilld
Скилл загружает справку по motion-v 2.4.4, Vue-порту Motion (бывший Framer Motion). Агент получает факты об API: независимые трансформы (x, y, scale, rotate), жесты (whileHover, whileDrag), анимацию входа и выхода через AnimatePresence, варианты для стаггера, скролл-привязки и layout-анимации по FLIP. Внутри — десять жёстких правил, которые закрывают частые ошибки: зачем LazyMotion вместо motion (с 34 кб до 6 кб), почему v-if нельзя вешать на AnimatePresence, как применять layout (менять CSS через :style, а не :animate) и когда нужны layoutScroll и layoutRoot.
Скилл требует Vue ≥ 3.0.0, @vueuse/core ≥ 10.0.0 и движок framer-motion ^13.3.0. Пакет motion-v — ESM-only, MIT. Без FFmpeg, Python или Docker: это чистый npm-пакет. Рецепты — вход/выход, stagger, drag, scroll-привязка, useAnimate, shared layout, Reorder-списки, директива v-motion, LazyMotion и настройка Nuxt. Миграция с 2.2.1: добавлен arc() для движения по дуге, многомерный Reorder (axis="xy"), восстановлен exit для KeepAlive-компонентов.
Какие задачи решает
- анимировать DOM и SVG через props без ручных requestAnimationFrame
- сделать stagger-анимацию с
customи динамическими вариантами - применить layout-анимацию (FLIP) при изменении размера или позиции
- уменьшить бандл с 34 кб до 6 кб через
LazyMotionиdomAnimation - связать анимацию со скроллом или жестами (hover, drag, inView)
Примеры запросов агенту
- Анимируй появление карточки через
motion.divс:initialи:animate - Добавь exit-анимацию на список через
AnimatePresence - Настрой layout-анимацию для grid, меняй размер через
:style, а не:animate
Как установить motion-v-skilld
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a claude-code2Вручную: положить файлы
~/.claude/skills/motion-v-skilld/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/motion-v-skilld/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a codex2Вручную: положить файлы
.agents/skills/motion-v-skilld/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a cursor2Вручную: положить файлы
.cursor/skills/motion-v-skilld/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install skilld-dev/vue-ecosystem-skills skills/motion-v-skilld2Вручную: положить файлы
.github/skills/motion-v-skilld/SKILL.md1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a gemini-cli2Командой платформы
gemini skills install https://github.com/skilld-dev/vue-ecosystem-skills --path skills/motion-v-skilldВручную: положить файлы
.devin/skills/motion-v-skilld/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о motion-v-skilld
Как установить motion-v-skilld в Claude Code?
Запусти npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a claude-code, скилл окажется в ~/.claude/skills/motion-v-skilld/SKILL.md.
Что делает motion-v-skilld?
Даёт агенту справку по motion-v 2.4.4: API компонентов motion, жестов, вариантов, layout-анимаций, директивы v-motion, Nuxt-модуля. Плюс десять жёстких правил против частых багов.
Зачем LazyMotion вместо motion?
Компонент motion тянет все фичи — 34 кб. m с LazyMotion начинает с 6 кб, domAnimation добавляет варианты и жесты, domMax — drag и layout. Поставь strict, чтобы ловить случайные motion в dev-сборке.
Исходный текст
SKILL.md · MIT
---
name: motion-v-skilld
description: ALWAYS load when writing or debugging code that imports "motion-v" (Motion for Vue, motion-vue). Covers the motion component, AnimatePresence, variants, gestures, layout, scroll, motion values, the v-motion directive, and the Nuxt module for version 2.4.4. Provides API facts, recipes, best practices, and migration notes.
license: MIT
---
# motion-v (Motion for Vue) 2.4.4
Motion for Vue is the Vue port of Motion (formerly Framer Motion).
It animates DOM and SVG through props, motion values, and a hybrid engine.
Facts, all verified from the prepared source:
- Package: `motion-v` 2.4.4, MIT, ESM only (package.json:4, package.json:20-33).
- Peer deps: `vue >= 3.0.0`, `@vueuse/core >= 10.0.0` (package.json:53-56).
- Engine deps: `framer-motion`, `motion-dom`, `motion-utils`, all `^13.3.0` (package.json:57-62).
- Entry points: `motion-v`, `motion-v/nuxt`, `motion-v/resolver` (package.json:20-33).
- The root entry re-exports all of `framer-motion/dom` (dist/es/index.d.ts:1). So `animate`, `stagger`, `arc`, easing functions, and more come from the Motion engine.
- Repo and docs: https://github.com/motiondivision/motion-vue, https://motion.dev/docs/vue
## Quick start
```
npm install motion-v
```
```vue
<script setup>
import { motion } from 'motion-v'
</script>
<template>
<motion.div :initial="{ opacity: 0 }" :animate="{ opacity: 1, x: 100 }" />
</template>
```
`motion` is a namespace of typed components for every HTML and SVG tag
(dist/es/components/motion/index.d.ts:3-182). `motion.div`, `motion.svg`, `motion.path` and so on.
## Core model
- Set `initial`, `animate`, `exit`, `whileHover`, `whilePress`, `whileInView`, `whileFocus`, `whileDrag` to values or variant labels.
- When `animate` values change, the element animates to them.
- `transition` configures timing, spring, delay, stagger.
- `variants` plus `custom` support dynamic, per element targets.
- Animatable values include independent transforms (`x`, `y`, `scale`, `rotate`, `skewX`), colors, and CSS variables (dist/es/types/state.d.ts:45-47).
- In templates, bind motion props with `:` prefix. They are props, not attributes.
Full prop and hook listing: [references/api-surface.md](./references/api-surface.md)
## Hard rules
These rules prevent the most common bugs. Each cites its source.
1. Use `m` plus `LazyMotion` instead of `motion` when bundle size matters.
`motion` ships all features, about 34 kb. `m` starts near 6 kb.
Load `domAnimation` for variants, gestures, exit. Load `domMax` for drag and layout.
Set `strict` to catch stray `motion` usage in dev.
https://motion.dev/docs/vue-lazymotion, dist/es/components/lazy-motion/index.d.ts:4-13
2. Never put `v-if` on `AnimatePresence` itself. If it unmounts, it cannot intercept child exits.
Put the condition on the direct child instead:
```vue
<AnimatePresence>
<motion.div v-if="isVisible" :exit="{ opacity: 0 }" />
</AnimatePresence>
```
https://motion.dev/docs/vue-animate-presence
3. For layout animations, apply changing CSS to `:style`, never to `:animate`.
The `layout` prop animates the measured change. Values in `:animate` fight the FLIP measurement.
https://motion.dev/docs/vue-layout-animations
4. Set `borderRadius` and `boxShadow` as inline styles on `layout` elements.
Motion corrects scale distortion for these two only when they are motion values in `:style`.
https://motion.dev/docs/vue-layout-animations#scale-correction
5. Add `layoutScroll` on scrollable ancestors and `layoutRoot` on fixed position ancestors.
Without them, layout measurement is wrong when scroll or viewport offset is non zero.
dist/es/components/motion/props.d.ts:71-78
6. Set `reducedMotion="user"` on a root `MotionConfig`.
The default is `"never"`, so animations ignore the OS accessibility setting unless you opt in.
dist/es/components/motion-config/types.d.ts:5-20
7. Use dynamic variants with `custom` for stagger, not computed delays in reactive state.
Pass `:custom="index"` and resolve `delay` inside the variant function.
https://motion.dev/docs/vue-animation
8. Render live motion values with `<RowValue :value="mv" />` in demos and readouts.
It writes `innerHTML` directly and keeps fast values off the Vue render path.
dist/es/components/RowValue.d.ts:1-15
9. Use `v-motion` for plain elements when a wrapper component does not fit.
Register it globally with `app.use(MotionPlugin)`, or create presets with `createPresetDirective`.
The directive supports SSR through `getSSRProps` and defaults to `domMax` features.
dist/es/directive/index.mjs:153-172
10. Gesture shorthand props `focus`, `hover`, `press`, `inView` were removed in v2.0.0.
Use `whileFocus`, `whileHover`, `whilePress`, `whileInView` for animation, and event props like `onHoverStart` for logic.
See [references/migration.md](./references/migration.md)
## Common tasks
Enter and exit, stagger, drag, scroll linked, imperative `useAnimate`, shared layout, Reorder lists, directive usage, LazyMotion, and Nuxt setup, each with a runnable snippet: [references/recipes.md](./references/recipes.md)
## Changes since the 2.2.1 baseline
- 2.3.0: `arc()` motion along an arc, usable as `transition: { path: arc(...) }`. `useAnimate` now respects `MotionConfig skipAnimations`.
- 2.4.0: multidimensional Reorder, `axis="xy"` on `Reorder.Group`.
- 2.4.2: exit and enter animations restored for `KeepAlive` cached components.
- 2.4.4: Nuxt module no longer transpires `motion-v` in builds.
Details and links: [references/migration.md](./references/migration.md)
## Version specific notes
- SVG positions use `attrX`, `attrY`, `attrScale` instead of `x`, `y`, `scale` (dist/es/types/state.d.ts:15-20).
- `useSpring` accepts a value or a `MotionValue` source and returns the matching type (dist/es/value/use-spring.d.ts:6-7).
- `useTransform` maps ranges and also returns a named map of outputs in one call (dist/es/value/use-transform.d.ts:54-97).
- `AnimatePresence` supports `mode` `sync`, `wait`, `popLayout`, plus `anchorX` for popLayout exit direction (dist/es/components/animate-presence/types.d.ts:1-8).
- Directive and components share one resolver, so `v-motion` inherits variant, presence, and config context (dist/es/utils/resolve-motion-props.d.ts:11-15).
© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills