Skip to the usage guide
review-animationsby Emil Kowalski

Review Animations Skill.

A Claude Code and Codex skill for design review: reviews animation code for timing, interaction, and finish against a high craft bar.

  • Design Review & Accessibility
  • Review report
emilkowalski/skills · skills/review-animations/SKILL.mdSKILL.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. --- ## Operating Posture ## The Ten Non-Negotiable Standards ## Aggressive Escalation Triggers ## Remedial Preference Hierarchy ## Required Output Format ## Guidelines
Front matter and section headings read from the upstream file on 2026-09-14 · 8,040 characters in full

01 What it does

What the review-animations Skill Does in Claude Code and Codex

Summary, workflow and outputs, all read from the skill's SKILL.md.

From the SKILL.mdRead 2026-09-14 · not a recorded run

In the Skill's Own Terms

A deliberately narrow review skill: it judges animation and motion code against a high craft bar and nothing else, declining general code review. Its substantive standards come from Emil Kowalski's animation philosophy, and its method — ten non-negotiable standards, aggressive escalation triggers, a nine-step remedial hierarchy, and tiered output — is built to end in one verdict.

The default is to flag; approval is earned. Every animation in the diff must justify itself by purpose and frequency, use responsive easing, stay under 300ms, scale from its trigger, run on transform and opacity, be interruptible, honor reduced motion, and use asymmetric timing. Output is a Before/After/Why findings table plus a Block or Approve decision, citing file:line.

Review report
See the example prompt ↗

How It Works

  1. 01
    Measure Against Ten Standards

    Every animation in the diff is checked against ten non-negotiables spanning justification, frequency, easing, duration, origin, interruptibility, GPU properties, accessibility, asymmetry and cohesion.

  2. 02
    Flag Escalation Triggers on Sight

    A listed set of red flags is called out hard rather than debated, including transition: all, scale(0) entrances, ease-in on UI, animation on keyboard or 100+/day actions, and missing reduced-motion handling.

  3. 03
    Prefer the Earliest Remedy

    Fixes are proposed in hierarchy order, from deleting the animation, to reducing it, to fixing easing, origin, interruptibility, GPU properties, timing, polish, and finally accessibility and cohesion.

  4. 04
    Emit the Two Required Parts

    The review comes back in a fixed order: Part 1 is a single findings table, Part 2 is tiered commentary that ends in an explicit decision.

  5. 05
    Tier Commentary and Decide

    Remaining commentary is grouped into six impact tiers, highest first, with empty tiers omitted, and closes with a Block or Approve decision.

02 Find your fit

When to Use the review-animations Skill

Use the review-animations skill in Claude Code or Codex when the job is design review of this kind. Fit and limits below are taken from the skill's own file.

Good Fit

  • Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Know the Boundaries

  • It does not write features, fix unrelated bugs, or review non-motion code.

03 Inside the skill

What the review-animations Skill Brings to Design Review

4 things the SKILL.md instructs Claude Code or Codex to do, in the file's own section order.

  1. 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.

  2. The Ten Non-Negotiable Standards

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

  3. Remedial Preference Hierarchy

    When proposing fixes, prefer earlier moves over later ones:

  4. Guidelines

    Prefer CSS transitions/@starting-style/WAAPI for predetermined motion; JS/springs for dynamic, interruptible, gesture-driven motion.; When unsure whether motion feels right, recommend reviewing it in slow motion / frame-by-frame a

04 Put it to work

Install review-animations in Claude Code or Codex

One npx skills add command, then a first task in your agent and a checklist for the result.

Add review-animations to Claude Code, Codex or Your Agent

Run in your project; the installer asks which agent to add it to.

Terminal
npx skills add https://github.com/emilkowalski/skills --skill review-animations

Generic skills CLI form for skills/review-animations/SKILL.md; the repository may document its own path.

Give the Skill a First Design Review Task

The SKILL.md does not include an example prompt; this starter is written from the catalog one-liner. Replace the task line with your real brief.

Starter prompt
Use the review-animations skill on the material I attach. What the skill should do here: Reviews animation code for timing, interaction, and finish against a high craft bar. Rules: do not invent copy, data or brand assets. State your plan first, then produce the result and tell me what to check.

Source: starter prompt written from the catalog one-line use (not from the SKILL.md).

Check the First Result

Before accepting the output, look for these in the transcript and the files:

  • The result is delivered as Review report, as the catalog lists for this skill.
  • The agent names the review-animations skill in its plan or transcript before producing the result.
  • Your own content, names and numbers appear unchanged in the output.

In OpenDesign review-animations is bundled: Plugins → Skills, pick it in the top bar.

05 Open source, traceable

Source, License and Verification

Where this page's facts come from, and when they were last checked.

Repository
github.com/emilkowalski/skills Branch main
Skill file
skills/review-animations/SKILL.md Content checksum recorded at verification; commit d23d7f8
License
MIT From LICENSE.
Repository stars
37,516 GitHub snapshot taken 2026-09-14 for the whole emilkowalski/skills repository, which contains 9 skills in this catalog. Not a rating or usage count for review-animations.
Verified by OpenDesign
2026-09-14 Source file, path, license text and star count were checked. Bundled in OpenDesign main (checked 2026-08-28); a live run has not been recorded on this page.
The Skill's Own 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.”

Front-matter description from SKILL.md. The full file is about 8,040 characters. Read the full file on GitHub.

Review Animations

Run review-animations on a Real Design Review Task.

The review-animations skill ships inside OpenDesign. Download the app, pick the skill in Plugins → Skills, paste the prompt above, and read the plan before the result.

Terminal
npx skills add https://github.com/emilkowalski/skills --skill review-animations