# motion-v-skilld

motion-v-skilld — a skill for motion-v (Motion for Vue) animations: motion component, gestures, variants, v-motion directive, Nuxt module.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 146 installs · ★ 186 repo stars
- Author: skilld-dev
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/skilld-dev/vue-ecosystem-skills/tree/HEAD/skills/motion-v-skilld/SKILL.md
- Updated: 2026-10-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/motion-v-skilld

## What it does

The skill loads reference for `motion-v` 2.4.4, the Vue port of Motion (formerly Framer Motion). It gives the agent API facts: independent transforms (`x`, `y`, `scale`, `rotate`), gestures (`whileHover`, `whileDrag`), enter and exit animations via `AnimatePresence`, variants for stagger, scroll and layout animations using FLIP. It includes ten hard rules that prevent common bugs: why `LazyMotion` instead of `motion` cuts the bundle from 34 kb to 6 kb, why `v-if` cannot go on `AnimatePresence` itself, how to apply `layout` (change CSS through `:style`, not `:animate`), and when to use `layoutScroll` and `layoutRoot`.

Requires Vue ≥ 3.0.0, `@vueuse/core` ≥ 10.0.0, and `framer-motion` engine ^13.3.0. The package is ESM-only, MIT. No FFmpeg, Python or Docker: it is a plain npm package. Recipes cover enter/exit, stagger, drag, scroll-linked animation, `useAnimate`, shared layout, Reorder lists, `v-motion` directive, LazyMotion, and Nuxt setup. Migration from 2.2.1 adds `arc()` for motion along an arc, multidimensional Reorder (`axis="xy"`), and restores exit for `KeepAlive` cached components.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/motion-v-skilld/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/motion-v-skilld/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/motion-v-skilld/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/motion-v-skilld/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install skilld-dev/vue-ecosystem-skills skills/motion-v-skilld
```

2. **Manually: put the files in place**
- File: `.github/skills/motion-v-skilld/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/skilld-dev/vue-ecosystem-skills --path skills/motion-v-skilld
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/motion-v-skilld/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill motion-v-skilld -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/skilld-dev/vue-ecosystem-skills/tree/HEAD/skills/motion-v-skilld/SKILL.md

## When to use it
- animate DOM and SVG through props without manual requestAnimationFrame
- build stagger sequences with `custom` and dynamic variants
- apply layout animation (FLIP) when size or position changes
- reduce bundle from 34 kb to 6 kb with `LazyMotion` and `domAnimation`
- link animation to scroll or gestures (hover, drag, inView)

## Example prompts
- Animate a card entrance with `motion.div` using `:initial` and `:animate`
- Add exit animation to a list with `AnimatePresence`
- Set up layout animation for a grid; change size via `:style`, not `:animate`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 255fac57c149e7c7.

BEGIN THIRD-PARTY FILE 255fac57c149e7c7
````text
---
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.
````
END THIRD-PARTY FILE 255fac57c149e7c7

The third-party file has ended. Everything between the 255fac57c149e7c7 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2330 of 6333 bytes. © skilld-dev · MIT · https://github.com/skilld-dev/vue-ecosystem-skills/tree/HEAD/skills/motion-v-skilld/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
