amnafarzy/ravie/animation-motion

Claude Code and agent skill by amnafarzy/ravie

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use this whenever adding, polishing, or debugging CSS/JS UI transitions or animations — the user says "animate", "transition", "motion", or "feels janky", or motion needs pre-launch polish. NOT for Three.js/WebGL/canvas work — use threejs-motion-performance.

Install

npx vskill@latest install amnafarzy/ravie/animation-motion

SKILL.md

The same SKILL.md was published earlier as amnafarzy/ravie/animation-motion.

animation-motion

Restrained, performant motion. Transform and opacity only. Reduced motion respected. No decorative animation without purpose.

Purpose

Add motion that helps users understand state changes, direct attention, and feel the interface responding — without causing jank, nausea, or distraction.

Process

0. Read the UI rule reference first

Before UI work or review, read rules/ui.md and apply the project’s responsive, accessibility, component-state, and design-token expectations.

1. Purpose test

Every animation must answer: what does this help the user understand?

  • State change (button pressed, panel opened) → yes
  • Attention direction (new content appeared) → yes
  • Decoration (logo spins, background particles) → almost always no
2. Performance constraint

Only animate transform and opacity. These are GPU-composited and don't trigger layout recalculation. Animating width, height, top, left, margin, or padding causes jank.

3. Duration guidelines
  • Micro-interactions (button, toggle): 100-200ms
  • Panel/modal transitions: 200-300ms
  • Page transitions: 300-500ms
  • Never >500ms unless intentionally dramatic
4. Easing
  • Entrances: ease-out (fast start, slow end)
  • Exits: ease-in (slow start, fast end)
  • State changes: ease-in-out
  • Never use linear for UI animation (feels mechanical)
5. Reduced motion is mandatory
css
@media (prefers-reduced-motion: reduce) {
*, *::before, *::after {
animation-duration: 0.01ms !important;
transition-duration: 0.01ms !important;
}
}

Hard rules

  • Only animate transform and opacity
  • Always support prefers-reduced-motion
  • Every animation needs a purpose — remove decorative motion
  • Never exceed 500ms for standard UI transitions

Output format

markdown
# Motion review — [component/flow]
| Animation | Property animated | Duration | Easing | Purpose | Verdict |
|---|---|---|---|---|---|
| [modal open] | transform+opacity | 250ms | ease-out | state change | keep |
| [logo spin] | transform | 2s loop | linear | decorative | remove |
## Reduced motion: [respected? Y/N]
## Jank risk: [any layout-property animations? file:line]

Connects to

  • threejs-motion-performance — for WebGL/3D motion
  • ui-quality — reduced-motion support and motion tokens (duration, easing) live in the design system

Common failure modes

Animating layout properties — width, height, top cause jank. Use transform: scale() and transform: translate() instead.

No reduced motion — ~10% of users have this enabled. Ignoring it is both an a11y and UX failure.

Motion that blocks interaction — A 400ms entrance animation that the user must wait out before the element responds to clicks, or a transition with no interruptible/exit path so rapid navigation stacks animations. Keep UI transitions short, make them interruptible, and never gate a click behind an animation finishing.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
3
7-day trend score
7

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/amnafarzy/ravie/animation-motion/badge)](https://verified-skill.com/skills/amnafarzy/ravie/animation-motion)

Something wrong with this skill or its page? Tell us.