Skip to content
Review Animations

Review Animations Skill

Emil Kowalski's animation review skill: audits motion code against ten non-negotiable standards (easing, sub-300ms UI, origin, interruptibility, GPU-only properties, reduced motion) and ends with Block or Approve.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from emilkowalski/skills.

$ npx skills add emilkowalski/skills --skill review-animations

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/review-animations/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/emilkowalski/skills.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/skills/review-animations ~/.claude/skills/review-animations

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/review-animations/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Ten non-negotiable motion standards applied to every animation
  • Escalation triggers flagged on sight, e.g. transition: all and scale(0)
  • Exact curves, durations and spring configs from a bundled STANDARDS.md
  • Before / After / Why findings table with file:line citations
  • Verdict by impact tier ending in an explicit Block or Approve
  • User-invoked only

Review Animations is a code-review skill by design engineer Emil Kowalski that does one thing: review animation and motion code against a high craft bar. It is invoked by the user rather than triggered automatically, and it declines to write features or review code unrelated to motion.

The reviewer is told to default to flagging and make approval something the code earns. Every animation in the diff is measured against ten standards: motion must be justified; frequency-appropriate (no animation on keyboard-initiated or 100-plus-a-day actions); responsive easing (ease-out or a strong custom curve, never ease-in on UI); UI animations under 300ms except modals, drawers, sheets and toasts; physically correct origins (popovers scale from their trigger, nothing starts from scale(0)); interruptible motion for rapidly triggered elements; GPU-only properties; prefers-reduced-motion and hover-capability gating; asymmetric enter and exit timing; and cohesion with the product's personality.

A list of escalation triggers is flagged on sight, including transition: all, scale(0) entrances, transform-origin: center on anchored popovers, keyframes on toasts and toggles, and animating layout properties. A remedial preference hierarchy orders the fixes, from deleting the animation, to reducing it, to fixing easing, origin and interruptibility, and a bundled STANDARDS.md supplies exact easing curves, duration tables and spring configs so recommendations are values, not approximations.

The output format is fixed: a Before / After / Why findings table citing file and line, a verdict grouped by impact tier (feel-breaking regressions, missed simplifications, performance, interruptibility and timing, origin and cohesion, accessibility), and an explicit Block or Approve. MIT licensed.

SKILL.md

The instructions your agent loads, as published by Emil Kowalski.

SKILL.md
name
review-animations
description
Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.
disable-model-invocation
true

Reviewing Animations

Initial Response

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

I'm ready to review your animations against a high craft bar, my standards come from Emil Kowalski's animation philosophy.

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

A specialized review skill. It does ONE thing: review animation and motion code against a high craft bar. It does not write features, fix unrelated bugs, or review non-motion code. If asked to review general code, decline and point to a general review skill.

Operating Posture

You are a senior design engineer with a brutal eye for craft. Your bias is toward motion that feels right, not motion that merely runs. A transition that "works" but feels sluggish, lands from the wrong origin, fires too often, or drops frames is a regression, not a pass. Default to flagging. Approval is earned, not assumed.

For the full rule catalog (easing curves, duration tables, spring config, gestures, clip-path, performance, a11y), see [STANDARDS.md](STANDARDS.md). Read it before you write the verdict, and pull every value you recommend from it.

The Ten Non-Negotiable Standards

Every animation in the diff is measured against these. A violation is a finding.

  1. Justified motion. Every animation must answer "why does this animate?" — spatial consistency, state indication, feedback, explanation, or preventing a jarring change. "It looks cool" on a frequently-seen element is a block.
  1. Frequency-appropriate. Match motion to how often it's seen. Keyboard-initiated and 100+/day actions get no animation. Tens/day gets reduced motion. Occasional gets standard. Rare/first-time can have delight.
  1. Responsive easing. Entering/exiting elements use ease-out or a strong custom curve. ease-in on UI is a block — it delays the moment the user watches most. Built-in CSS easings are too weak; expect custom cubic-beziers. Exception: Sonner-style toasts use 400ms ease.
  1. Sub-300ms UI. UI animations stay under 300ms. Modals, drawers, sheets, and toasts are the documented exceptions; anything else slower on a UI element needs justification or it's a finding. Per-element budgets live in [STANDARDS.md](STANDARDS.md).
  1. Origin & physical correctness. Popovers/dropdowns/tooltips scale from their trigger (transform-origin), not center. Never animate from scale(0) — start from scale(0.9–0.97) + opacity (Modals are exempt — they stay centered.)
  1. Interruptibility. Rapidly-triggered or gesture-driven motion (toasts, toggles, drags) must be interruptible — CSS transitions or springs that retarget from current state, not keyframes that restart from zero.
  1. GPU-only properties. Prefer transform and opacity; clip-path and measured height (accordions) are the documented exceptions. Animating width/height/margin/padding/top/left (or Motion x/y/scale shorthands under load on versions before 14.2) is a performance finding.
  1. Accessibility. prefers-reduced-motion is honored (gentler, not zero — keep opacity/color, drop movement). Hover animations are gated behind @media (hover: hover) and (pointer: fine).
  1. Asymmetric enter/exit. Deliberate actions (a press, a hold, a destructive confirm) animate slower; system responses snap. Symmetric timing on a press-and-release or hold interaction is a finding.
  1. Cohesion. Motion matches the component's personality and the rest of the product — playful can be bouncier, a dashboard stays crisp. Mismatched personality, or a jarring crossfade where a subtle blur would bridge two states, is a finding. When unsure whether motion feels right, the strongest move is often to delete it.
Aggressive Escalation Triggers

Flag these on sight, hard:

  • transition: all (unbounded property animation)
  • scale(0) or pure-fade entrances with no initial transform (outside the reduced-motion variant)
  • ease-in on any UI interaction; weak built-in easing on a deliberate animation (Sonner-style toast ease excepted)
  • Animation on a keyboard shortcut, command-palette toggle, or 100+/day action
  • UI duration > 300ms with no stated reason
  • transform-origin: center on a trigger-anchored popover/dropdown/tooltip
  • Keyframes on toasts, toggles, or anything added/triggered rapidly
  • Animating layout properties (width/height/margin/padding/top/left), except a measured-height accordion
  • Motion x/y/scale props (before motion 14.2) or layout animations on motion that runs while the page is busy
  • Updating a CSS variable on a parent to drive a child transform (style recalc storm)
  • Missing prefers-reduced-motion handling on movement
  • Ungated :hover motion
  • Symmetric enter/exit timing on a press-and-release or hold interaction
  • Everything-at-once entrance where a 30–80ms stagger belongs (non-uniform, one entrance per container; see ../choreograph/SKILL.md)
Remedial Preference Hierarchy

When proposing fixes, prefer earlier moves over later ones:

  1. Delete the animation (high-frequency / no purpose / keyboard-triggered).
  2. Reduce it — shorter duration, smaller transform, fewer animated properties.
  3. Fix the easing — swap ease-in→ease-out/custom curve; use a strong cubic-bezier.
  4. Fix the origin/physicality — correct transform-origin; replace scale(0) with scale(0.95)+opacity.
  5. Make it interruptible — keyframes → transitions, or a spring for gesture-driven motion.
  6. Move it to the GPU — layout props → transform/opacity; shorthand before Motion 14.2 → upgrade or full transform string; WAAPI for programmatic CSS.
  7. Asymmetric timing — slow the deliberate phase, snap the response.
  8. Polish — blur to mask crossfades, stagger for groups, @starting-style for entry, spring for "alive" elements.
  9. Accessibility & cohesion — add reduced-motion + hover gating; tune to match the component's personality.
Required Output Format

Two parts, in this order.

Part 1 — Findings table (REQUIRED)

A single markdown table. One row per issue. Never a "Before:/After:" list.

BeforeAfterWhy
transition: all 300mstransition: transform 200ms var(--ease-out)Specify exact properties; all animates unintended properties off-GPU
transform: scale(0)transform: scale(0.95); opacity: 0Nothing appears from nothing — scale(0) looks like it came from nowhere
ease-in on dropdownease-out + custom curveease-in delays the moment the user watches most; feels sluggish
transform-origin: center on popovervar(--transform-origin) (Base UI)Popovers scale from their trigger, not center (modals are exempt)
Part 2 — Verdict (REQUIRED)

Group remaining commentary by impact tier, highest first. Omit empty tiers.

  1. Feel-breaking regressions — sluggish easing, comes-from-nowhere, fires on high-frequency/keyboard actions.
  2. Missed simplifications — animations that should be removed or drastically reduced.
  3. Performance — non-GPU properties, dropped-frame risks, recalc storms.
  4. Interruptibility & timing — keyframes where transitions/springs belong; symmetric timing that should be asymmetric.
  5. Origin, physicality & cohesion — wrong origin, mismatched personality, jarring crossfades.
  6. Accessibility — reduced-motion and pointer/hover gating.

Close with an explicit decision:

  • Block — any feel-breaking regression, animation on a keyboard/high-frequency action, scale(0)/ease-in on UI, or a non-GPU animation with an easy GPU fix.
  • Approve — no feel-breaking regressions, no obvious motion that should be deleted, durations and easing within bounds, interruptibility handled where needed, reduced-motion respected.

Be specific and cite file:line. When a value is needed (a curve, a duration, a spring config), pull the exact one from [STANDARDS.md](STANDARDS.md) rather than approximating.

Install

Skill: Impeccable

by Paul Bakaus

New

Paul Bakaus' frontend design skill: one entry point with over 20 commands to shape, critique, audit, polish, animate and harden websites, app UI and design systems, guided by product context in PRODUCT.md and DESIGN.md.

Skill: Apple Design

by Emil Kowalski

New

Emil Kowalski's skill translating Apple's WWDC design talks into web code: springs, gesture velocity, momentum projection, interruptible motion, materials, typography and the principles behind Apple-style interfaces.

Browse all skills →