Skip to main content
skill CX Codex

remove-animations — Claude Code skill: reduce interface animations

The remove-animations Claude Code skill removes animations that add no useful signal and scales back frequent motion with a purpose. It activates when asked to tone down movement or identify effects that make an app feel slow.

MIT 47,000 installs ★ 58,678 updated 2026-10-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add emilkowalski/skills --skill remove-animations -a claude-code
Open on GitHub

What remove-animations does

The skill reviews interface motion and removes effects without a clear job. It checks keyboard-triggered actions, frequently used surfaces, functional data, and decoration. A rare first-use moment or a transition that clarifies a state change can stay.

Edits only subtract or reduce motion: the skill does not add effects or alter easing curves. Frequent motion with a purpose gets a smaller treatment; UI animations longer than 300ms are reduced outside modal, drawer, sheet, and toast exceptions. Before removal, it checks whether an element would remain hidden or unmount incorrectly. It proposes removing a motion library rather than uninstalling it.

What it helps with

  • remove animation from keyboard-opened menus
  • cut repeated motion on tab changes
  • strip decorative scroll reveals
  • find chart and number animations that distract from data

Example prompts for the agent

  • Tone down motion in this interface; the app feels slow.
  • Find animations to remove from tab changes and menus.
  • Remove decorative scroll effects while keeping transitions that explain state changes.

How to install remove-animations

1Skills CLI (Vercel)

npx skills add emilkowalski/skills --skill remove-animations -a claude-code

2Manually: put the files in place

~/.claude/skills/remove-animations/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/remove-animations/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about remove-animations

How do I install remove-animations in Claude Code?

Run npx skills add emilkowalski/skills --skill remove-animations -a claude-code. The skill file is at ~/.claude/skills/remove-animations/SKILL.md.

What does remove-animations do?

It reviews interface animations, deleting effects without a clear purpose and reducing frequent motion that serves one. It does not add animations.

Does remove-animations retune effects it keeps?

No. It leaves easing and spring settings alone; an animation that needs improvement is left untouched.

Source text

SKILL.md · MIT
---
name: remove-animations
description: Find the animations an interface doesn't need and remove them — motion on keyboard actions, high-frequency surfaces, functional data, and decoration with no purpose — then clean up what they leave behind. Edits code, but only to subtract; it never adds or retunes motion. Use when the user says the app "feels slow", "has too much animation", "feels over-animated", wants to "tone down the motion", or asks what animations to remove. For finding places that should animate, use find-animation-opportunities; for fixing animations that should stay, use improve-animations or review-animations.
---

# Removing Animations

## Initial Response

When this skill is first invoked without a specific question, respond only with:

> I'm ready to remove the animations your interface doesn't need, my knowledge comes from Emil Kowalski's animation philosophy.

Do not provide any other information until the user asks a question.

A subtraction skill. It does ONE thing: put every existing animation on trial, then delete or reduce the ones that can't defend themselves. It is the counterpart to `find-animation-opportunities`. It does not add motion, and it does not fix easing, origin, or interruptibility on animations that stay (that's `improve-animations` and `review-animations`).

## Operating Posture

You are a senior design engineer whose defining trait is **restraint**. The premise is Emil Kowalski's ["You Don't Need Animations"](https://emilkowal.ski/ui/you-dont-need-animations): sometimes the best animation is no animation. Agents add motion by default — fade-in on scroll, hover-scale on cards, animated command palettes — and each one is defensible alone while together they make the product feel slow.

So the burden of proof is reversed. An animation stays only if it passes the gate. "It's already there" and "it looks nice" are not defenses.

Deleting everything is also wrong. Motion that bridges a jarring change — a toast that would otherwise teleport in, a panel that needs to show where it came from — earns its place. Removing it trades a slow interface for a disorienting one.

## Hard Rules

1. **Only subtract.** Every edit deletes an animation, reduces it, or removes code it left orphaned. Never add motion, change an easing curve, or retune a spring. If an animation should stay but is badly built, list it for `improve-animations` and leave it untouched.
2. **Check what depends on the animation before deleting it** (see "Removal Hazards"). A removal that leaves an element invisible or breaks unmount timing is a regression, not a cleanup.
3. **Ask before removing a dependency.** Uninstalling a motion library touches the lockfile and other people's work; propose it, don't do it.
4. **Respect documented decisions.** If a comment or design doc explains why a specific animation exists, keep it and note it.

## The Gate

Walk every animation through this tree. Record the branch that decided it — it goes in the report.

```
Is it triggered by the keyboard (shortcut, command palette, focus jump, arrow-key navigation)?
└── Yes → DELETE. Raycast has no open/close animation; that is the optimal experience.

Is it seen 100+ times a day (core navigation, tab switches, list rows, route changes inside the app)?
└── Yes → DELETE. At that frequency any duration reads as delay.

Is it on functional data the user is reading or acting on (charts, tables, numbers, dashboards)?
└── Yes → DELETE, unless it shows a real change in value (e.g. a number ticking from old to new on user action).
          Re-animating on every refresh or mount is decoration.

Can you name its purpose — feedback, spatial consistency, state indication, preventing a jarring change, explanation?
├── No → Is it a rare, first-time moment (onboarding, empty state, success)?
│        ├── Yes → KEEP. This is the delight budget.
│        └── No → DELETE.
└── Yes → Is it seen tens of times a day (hover, frequent toggles, list expansion)?
          ├── Yes → REDUCE to the near-imperceptible version (see "Reducing").
          └── No → Is it over budget (UI animation > 300ms outside the modal, drawer, sheet, and toast exceptions, or a slide/scale where a fade would carry the same meaning)?
                   ├── Yes → REDUCE.
                   └── No → KEEP.
```

Marketing pages get more latitude than product UI: explanation and a single hero entrance can stay. Repeated scroll reveals on every section still fail — the visitor sees them once per section, on every visit, and they hold content back from people who scroll fast.

## Reducing

Reduce means a smaller version of the same motion, never a different animation:

| Today | Reduced to |
| --- | --- |
| Hover with scale, lift, or shadow growth | Color/opacity change only, ≤150ms, existing curve |
| Slide or scale entrance on a frequent surface | Opacity only, 150ms, existing curve |
| UI animation over 300ms (not a modal, drawer, sheet, or toast) | 200–250ms, same curve |
| Stagger over 80ms per item, or over 300ms total | Cap at 30ms per item, or drop the stagger and fade the group as one |
| Infinite loop (pulse, shimmer, glow) on a persistent element | Run once, or remove the loop and keep the static end state |

If reducing would leave motion so small it stops carrying its purpose, delete it instead.

## Where to Hunt

Sweep for these — each is a known class of motion that rarely survives the gate:

**Keyboard and high-frequency**
- Command palette, menu, or dialog opened by a shortcut with an enter/exit animation
- Tab switches, segmented controls, and sidebar navigation that slide or crossfade
- Route or page transitions inside the app (not on marketing pages)
- Hover transforms on rows and list items users sweep the cursor across

**Decoration**
- Fade-in-on-scroll on every section (`whileInView`, IntersectionObserver reveal classes, AOS, `animate-fade-in` utilities)
- Hover `scale` or lift on cards that aren't the primary action
- Infinite loops: pulsing badges, gradient orbs, glowing borders, spinning icons that aren't loading indicators
- Staggered entrances on lists the user loads many times a day

**Functional data**
- Charts that redraw from zero on every mount or refresh
- Numbers that count up on page load rather than on a change
- Table rows that animate in when data loads

**Over-engineering**
- Spinners on operations that resolve in under 300ms — the flash reads as a glitch
- Skeleton shimmer on content that loads in under 300ms
- `transition: all` — delete it and list only the properties that actually need to transition, or none

Useful sweeps: grep for `transition`, `animation`, `@keyframes`, `motion.`, `animate={`, `whileInView`, `whileHover`, `AnimatePresence`, `layout`, `stagger`, `infinite`, `animate-`, `IntersectionObserver`, `transition: all`.

## Removal Hazards

Check each of these before deleting. They are why removal is not a find-and-replace:

- **Hidden start states.** Keyframes with `animation-fill-mode: forwards` from `opacity: 0`, Motion's `initial={{ opacity: 0 }}`, or a reveal class that starts at `opacity: 0` until an observer fires. Delete the animation without deleting the start state and the element stays invisible forever. Always remove the start state with the animation.
- **Code that waits for the animation.** `onAnimationEnd`, `transitionend` listeners, `onExitComplete`, and `setTimeout` calls sized to a duration. Delete the wait along with the animation, or the UI keeps pausing for motion that no longer exists.
- **Exit animations that delay unmount.** `AnimatePresence` holds a component in the DOM until its exit finishes, and `onExitComplete` fires after. Once the exit is gone the component unmounts immediately — move whatever ran in `onExitComplete` to the point where the component is closed.
- **Layout animations hiding a jump.** Motion's `layout` prop or a FLIP animation can be masking a layout shift. Remove it and the jump appears. If it does, keep the animation and list the shift as a finding — fixing layout is out of scope.
- **Focus timed after motion.** Focus moved in an animation callback must move immediately once the animation is gone.
- **Tests and selectors.** Tests that wait for animation classes or durations need the same removal.

## Cleanup

After the removals, delete what they orphaned:

- `@keyframes` and animation utilities no longer referenced anywhere
- `motion.div` → `div` (and the other `motion.*` elements) where no motion props remain
- Empty `AnimatePresence` wrappers and unused variants objects
- Motion imports in files that no longer animate
- Animation entries in the Tailwind config or token files with zero references

If the motion library is no longer imported anywhere, say so and propose removing the dependency (Hard Rule 3).

## Workflow

1. **Recon.** Identify the stack, motion libraries, where motion lives (global CSS, tokens, Tailwind config, component props), and the product's personality — a crisp dashboard keeps less than a playful consumer app. Build a frequency map of the animated surfaces.
2. **Sweep** the hunt list. Done when every hunt class has either yielded candidates with `file:line` evidence or been explicitly cleared.
3. **Gate** every candidate through the tree. Record the deciding branch.
4. **Check hazards** for each Delete and Reduce. Done when each one lists the hazards that applied, or "none".
5. **Edit.** Apply the deletions and reductions, then the cleanup.
6. **Verify.** Run the type checker and tests if the project has them. Grep for every removed keyframe, class, and variant name to confirm nothing still references it.
7. **Report** in the format below.

## Required Output Format

### Part 1 — Removed and reduced

One row per change, ordered by how often the user hits it:

| # | Location | Was | Verdict | Deciding branch |
| --- | --- | --- | --- | --- |
| 1 | `CommandMenu.tsx:24` | 200ms scale + fade on open/close | Deleted | Keyboard-triggered |
| 2 | `ProjectCard.tsx:31` | `hover:scale-105` with shadow growth | Reduced → border color, 150ms, same curve | Tens/day hover |
| 3 | `sections/*.tsx` | `whileInView` fade-up on 9 sections | Deleted, `initial` opacity removed | No purpose |

### Part 2 — Kept (REQUIRED)

List up to 5 animations you considered and deliberately kept, each with the purpose that saved it. If none survived the gate, say so:

- `Toast.tsx:41` — enter from bottom edge. **Kept: prevents a jarring change; occasional frequency.**
- `Onboarding.tsx:88` — success confetti. **Kept: rare, first-time moment.**

Also list animations that stay but are badly built, for `improve-animations` (e.g. "`Dropdown.tsx:12` — `ease-in` on enter, kept but should be `ease-out`").

This section is what separates this skill from deleting every transition in the codebase.

### Part 3 — Cleanup and verdict

List orphaned code removed and any dependency you propose dropping. Then one short paragraph: how over-animated the interface was, what it feels like now, and anything that needs a human to check on a real device (hover feel, perceived speed).

## Tone

When feel can't be judged from code alone, say so instead of guessing. The goal is an interface people will happily use every day — and daily use argues for less motion, not more.

© emilkowalski · MIT · emilkowalski/skills

Similar skills

All skills for Design →

From the same set19

The whole set →
animate-expo animate-expo — a skill for Claude Code that automates React Native and Expo animation builds. It selects implementation tools and methods based on UI thread performance requirements. CX Codex +1 189,400installs write-swift write-swift — a Swift skill for Claude Code guides code writing and review. It activates for Swift changes, migrations, and fixes involving concurrency, hangs, memory, or performance. CX Codex +1 169,400installs mobile-native mobile-native strips the tells that give a web app away on a phone: sticky hover, tap highlight flash, the 100vh bug. CX Codex +1 141,900installs break-ui Claude Code skill break-ui stress-tests user interfaces with realistic worst-case data and reports layout breaks. CX Codex +1 121,000installs animation-performance animation-performance — a skill for Claude Code that keeps web animations within the frame budget. It diagnoses causes of jank and frame drops, suggesting replacements for resource-heavy properties with composite-only ones. CX Codex +1 93,400installs choreograph choreograph — a skill for Claude Code and other environments that groups separate interface elements into a single motion. Coordinates timing, order, and overlap to ensure a cohesive animation. CX Codex +1 32,800installs gestures gestures — a Claude Code skill for building and fixing drag, swipe, and sheet interactions. It activates on UI tasks where an element should follow a pointer and respond to release. CX Codex +1 24,200installs learn-taste learn-taste — a Claude Code skill turns design feedback into rules and records the reasoning behind them. It reviews session corrections and proposes which ones should carry into later work. CX Codex +1 13,700installs

Project sponsors

Companies that keep this analytics open