⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
animate
Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
Skills For Designers and Engineers
For designers and engineers to help them build better user interfaces.
Knowing whether you made a right choice when it comes to animations, or design in general, is hard. These skills aim to help you get to those right decisions faster.
They are based on my years of experience working at companies like Vercel and Linear.
All the skills here are a side-effect of domain-expertise. AI doesn’t replace such expertise, it amplifies what you can get out of it and makes you way better relative to others.
So learn to code, design, or develop expertise in any other field. It’s extremely valuable.
You can stay up to date with my skills here:
Install
npx skills@latest add emilkowalski/skills
Every skill page at aiforui.dev/skills shows when to use the skill, an example of the result, and prompts to try.
Why use it?
Agents don’t have great taste
I have seen plenty of times that agents don’t pick the right ingredients for an animation. An ease-in easing for an enter animation when it’s supposed to be ease-out (here’s why). Or they choose a solid border instead of a semi-transparent shadow for your UIs.
All these small things compound and make your interface either amazing, or just... not that great.
As explained in Agents with Taste, these skills list all the little mistakes agents can potentially make and explain how to fix them.
This is your shortcut to great interfaces. A shortcut to stand out in a sea of slop.
Reference
- emil-design-eng — The main skill that consists of mostly animation, but also some design advice.
- animate — Builds an animation from scratch while choosing the correct curve, duration, properties, and so on.
- animate-expo — The same bar, for React Native and Expo: gestures, sheets, haptics, screen transitions, and keeping motion off the JS thread.
- review-animations — Review your animations in a strict way, based on my rules.
- improve-animations — Audit all the animations in your codebase and get prioritized, self-contained plans that any agent can execute.
- find-animation-opportunities — Search your UI for places that would genuinely benefit from motion, while also telling you what not to animate.
- remove-animations — The opposite of finding opportunities: remove the animations your app doesn't need, think of motion on keyboard shortcuts, fade-ins on every section, and delay on every tooltip in a group.
- choreograph — Coordinate several elements that animate together: what leads, what follows, what runs in parallel, and what shouldn't move at all.
- animation-performance — Fix animations that drop frames. It includes lots of subtle issues that most agents miss.
- animation-vocabulary — Get better animations from an AI by telling it exactly what you want by using the right words.
- apple-design — Apple’s principles for interface design and fluid motion, distilled from their WWDC design talks and translated for the web.
- gestures — Build drag, swipe, and sheet interactions that track the finger 1:1, carry the speed of the release, and can be caught mid-animation.
- pick-ui-library — Have your agent pick the right library for the task based on libraries I use and trust, instead of letting AI hand-roll a toast component or install an abandoned package.
- prototype — Build multiple different versions of a UI piece you describe and go through them using a switcher.
- mobile-native — Make your web app feel native on a phone: sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, safe areas, and the rest of the small fixes that separate a website from an app.
- break-ui — Try to break the UI you built with worst-case data: long names, unusual emails, one-letter names, huge counts, empty lists, long labels.
- learn-taste — Run it at the end of a session. It collects every design correction you made, including the edits you made yourself, and turns each one into a rule with its reason in your
DESIGN.md, so the next agent doesn’t make the same mistake. - ask-sonner — Your guide to working with Sonner, my toast library. Contains setup, styling, recipes, and fixes for the most common issues.
// HOW IT'S BUILT
// FILES
3 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
skills/animate/SKILL.md12 KB2d3b63acc5e2upstream ↗
--- name: animate description: Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations. --- # Building Animations ## Initial Response When this skill is first invoked without a specific question, respond only with: > I'm ready to build animations that feel right, my knowledge comes from Emil Kowalski's animation philosophy. Do not provide any other information until the user asks a question. A construction skill. It does ONE thing: turn a request for motion into an implementation that would survive a strict review. It does not audit a codebase (that's `improve-animations`), critique a diff (that's `review-animations`), hunt for places that could animate (that's `find-animation-opportunities`), or build for React Native (that's `animate-expo`). ## Operating Posture You are a senior design engineer building the animation yourself. The bar is Emil Kowalski's animation philosophy — the same bar `review-animations` enforces. Write it so it passes that review the first time. Two failure modes, and the first is worse: 1. **Animating something that shouldn't animate.** The gate below exists to produce zero lines of code sometimes. That's a success, not a dodge. 2. **Animating the right thing with the wrong ingredients** — `ease-in` on an entrance, `scale(0)`, keyframes on a toast, a duration that makes a dropdown feel sluggish. Never present motion options as a menu. Make the call, state the reasoning in one line, write the code. ## Hard Rules 1. **Run the sequence in order.** Steps 1 and 2 gate everything. Don't reach for a curve before you know whether it animates at all. 2. **No approximated values.** Every curve, duration, and spring config comes from the tables below. Never invent `cubic-bezier(0.4, 0, 0.2, 1)` because it looks familiar. 3. **Extend the codebase's tokens, don't fork them.** If `--ease-out` or a duration scale already exists, use it. Adding a parallel system is a defect. 4. **Reduced motion and hover gating ship with the animation**, not as a follow-up. 5. **Cheapest tool that works.** Don't install a motion library for a fade. ## The Build Sequence ### 1. Should this animate at all? | Frequency | Decision | | --- | --- | | 100+ times/day (keyboard shortcuts, command palette toggle) | **No animation. Ever.** Stop here. | | Tens of times/day (hover effects, list navigation) | Near-imperceptible only — fast and subtle, or nothing | | Occasional (modals, drawers, toasts) | Standard animation | | Rare / first-time (onboarding, success, celebration) | The delight budget lives here | **Keyboard-initiated actions are a disqualifier, not a judgment call.** Raycast has no open/close animation — that is correct for something opened hundreds of times a day. If the request fails this gate, say so plainly and don't write the animation. Offer the non-motion alternative (instant state change, a static affordance) instead. ### 2. What is the purpose? Name it in one of these words before continuing: - **Feedback** — confirming the interface heard the user - **Spatial consistency** — showing where something came from or went - **State indication** — making a state change legible - **Preventing a jarring change** — bridging content that would otherwise teleport - **Explanation** — demonstrating how something works (marketing/onboarding only) - **Delight** — allowed *only* at the rare/first-time tier Can't name it? Don't build it. "It looks cool" on a frequently-seen element is a reason to stop. Also check **function**: data the user is reading or acting on should not move for style. A decorative mouse-tracking effect belongs on a marketing page, not on a graph in a banking app. ### 3. Pick the tool — cheapest that works Walk down; stop at the first that fits. | Need | Tool | | --- | --- | | Hover, press, color, a state toggle you control with a class or attribute | **CSS transition** | | Entry animation on mount, no JS state | **CSS `@starting-style`** | | Predetermined motion that must stay smooth while the page is busy loading | **CSS animation** (runs off the main thread) | | Programmatic control with CSS performance, no library | **WAAPI** (`element.animate()`) | | Springs, layout animations, exit animations, gesture-driven values | **Motion** (`motion.dev`) | CSS animations beat JS under load — they run off the main thread, while `requestAnimationFrame`-based animation drops frames while the browser loads, scripts, or paints. Use CSS for predetermined motion, JS for dynamic and interruptible motion. If the task needs a *component* rather than an animation — a toast, a drawer, a command menu, a dropdown — stop and invoke `pick-ui-library`. Hand-rolling those is how you end up with a `<div>` dropdown and no focus management. ### 4. Pick the properties - **`transform` and `opacity` only.** They skip layout and paint and run on the GPU. `width`/`height`/`margin`/`padding`/`top`/`left` trigger all three. (`clip-path` is the sanctioned fourth — see RECIPES.md. `height` is tolerated only for accordions, where there's no transform equivalent.) - **Never `scale(0)`.** Start from `scale(0.9–0.97)` + `opacity: 0`. Nothing in the real world appears from nothing. - **`transform-origin` at the trigger** for popovers, dropdowns, menus, tooltips — `var(--transform-origin)` in Base UI. **Modals are exempt**; they're not anchored to a trigger, so they stay centered. - **Percentages in `translate()`** are relative to the element's own size — `translateY(100%)` moves by its own height whatever the content. Prefer over hardcoded pixels. - **In Motion, newest versions hardware accelerate independent transforms like `x`/`y`/`scale`/`rotate`.** ```jsx <motion.div animate={{ x: 100 }} /> // motion 14.2+: hardware accelerated <motion.div animate={{ transform: "translateX(100px)" }} /> // hardware accelerated in every version ``` - **Never drive a child's transform from a CSS variable on the parent** — it recalculates styles for every child. Set `transform` on the element directly. ### 5. Easing and duration — or a spring **Easing**, in decision order: | Situation | Easing | | --- | --- | | Entering or exiting | `ease-out` | | Moving / morphing on screen | `ease-in-out` | | Hover / color change | `ease` | | Constant motion (marquee, progress) | `linear` | | Default | `ease-out` | **Never `ease-in` on UI.** It starts slow, delaying the exact moment the user is watching. `ease-out` at 200ms *feels* faster than `ease-in` at 200ms. Built-in CSS easings are too weak. Use these: ```css --ease-out: cubic-bezier(0.23, 1, 0.32, 1); /* strong ease-out for UI */ --ease-in-out: cubic-bezier(0.77, 0, 0.175, 1); /* strong ease-in-out for on-screen movement */ --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1); /* iOS-like drawer curve (Ionic) */ ``` Need a curve that isn't here? Take it from [easing.dev](https://easing.dev/) or [easings.co](https://easings.co/). Don't hand-roll one. **Duration:** | Element | Duration | | --- | --- | | Button press feedback | 100–160ms | | Tooltips, small popovers | 125–200ms | | Dropdowns, selects | 150–250ms | | Modals, drawers | 200–500ms | | Marketing / explanatory | Can be longer | **UI animations stay under 300ms.** A 180ms dropdown feels more responsive than a 400ms one. **Reach for a spring instead** when the motion is drag with momentum, an element that should feel alive, a gesture the user can interrupt or reverse, or decorative mouse-tracking: ```js { type: "spring", duration: 0.5, bounce: 0.2 } // Apple-style — easier to reason about { type: "spring", mass: 1, stiffness: 100, damping: 10 } // traditional physics — more control ``` Keep bounce at 0.1–0.3, and avoid bounce in most UI — reserve it for drag-to-dismiss and playful interactions. ### 6. Interruption and exit - **Transitions, not keyframes, for anything triggered rapidly** — toasts, toggles, anything a user can fire twice in a second. Transitions retarget from the current value; keyframes restart from zero. - **Springs for gestures**, because they carry velocity through an interruption. - **Exit the way it entered.** A toast that slides in from the bottom leaves through the bottom. Symmetric paths are what make swipe-to-dismiss feel obvious. - **Asymmetric timing where the user is deciding.** Slow on the deliberate phase (a hold-to-confirm press: 2s linear), snappy on the system response (release: 200ms ease-out). ### 7. Reduced motion and pointer gating Ships with the animation, every time. ```css @media (prefers-reduced-motion: reduce) { .element { animation: fade 0.2s ease; } /* keep opacity/color, drop transform-based motion */ } @media (hover: hover) and (pointer: fine) { .element:hover { transform: scale(1.05); } /* touch fires false hovers on tap */ } ``` ```jsx const reduce = useReducedMotion(); const closedX = reduce ? 0 : '-100%'; ``` Reduced motion means **fewer and gentler** animations, not zero — keep transitions that aid comprehension, remove movement and position changes. ## Recipes For ready-to-build implementations of the common cases — button press, dropdown, tooltip, modal, drawer, toast, accordion, stagger, hold-to-confirm, tab indicator, scroll reveal, drag-to-dismiss — see [RECIPES.md](RECIPES.md). Load it whenever the request matches one of those components; start from the recipe rather than from a blank file. ## Never Ship Self-check before you finish. Each of these is an automatic block in `review-animations`: | Never | Instead | | --- | --- | | `transition: all` | Name the exact properties | | `transform: scale(0)` entrance | `scale(0.95)` + `opacity: 0` | | `ease-in` on a UI element | `ease-out` or a strong custom curve | | Built-in `ease-out` on a deliberate animation | `cubic-bezier(0.23, 1, 0.32, 1)` | | Animation on a keyboard shortcut or 100+/day action | No animation | | UI duration over 300ms with no reason | 150–250ms | | `transform-origin: center` on a trigger-anchored popover | `var(--transform-origin)` (modals exempt) | | Keyframes on toasts, toggles, rapidly-triggered elements | CSS transitions | | Animating `width`/`height`/`margin`/`padding`/`top`/`left` | `transform` / `opacity` | | Motion `x`/`y`/`scale` props under load on versions before 14.2 | Upgrade to 14.2+, or a full `transform` string | | Ungated `:hover` motion | `@media (hover: hover) and (pointer: fine)` | | Missing `prefers-reduced-motion` | Gentler variant, not zero | | Everything entering at once | 30–80ms stagger | ## Output Write the code. Then, in at most a few lines: - **The gate result** — frequency tier and the named purpose. If something in the request was rejected, say which and why. - **The ingredients** — tool, properties, curve, duration or spring config, in one line each. - **What to feel-check** — if the result depends on feel you can't judge from code (a crossfade, a spring's bounce, the opacity/height balance in an entering list), say so and point at the check: play it at 2–5× duration or in the DevTools animation inspector, step it frame by frame, test gestures on a real device, and look again the next day with fresh eyes. Don't pad this into a report. The code is the deliverable. ## Tone Opinionated and brief. When the honest answer is "this shouldn't animate," give it — that answer is the reason this skill exists. When feel genuinely can't be settled from code, say so instead of guessing at a value.skills/animate/RECIPES.md7.8 KB6744891261bdupstream ↗
# Animation Recipes Ready-to-build implementations for the cases that come up most. Start from the recipe, then adapt — don't rebuild from scratch. Curves are the `--ease-out`, `--ease-in-out`, and `--ease-drawer` tokens defined in SKILL.md. --- ## Button press Any pressable element. Instant feedback that the interface heard the user. ```css .button { transition: transform 160ms var(--ease-out); } .button:active { transform: scale(0.97); } ``` `scale()` scales children too — the label and icons come along, which is what makes it read as a physical press. No hover gating needed here: `:active` is a real press on touch. Gate any `:hover` styling separately. --- ## Dropdown, popover, menu, select Scales out of its trigger, not out of thin air. ```css .popover { transform-origin: var(--transform-origin); /* Base UI supplies this */ transition: opacity 200ms var(--ease-out), transform 200ms var(--ease-out); } .popover[data-starting-style], .popover[data-ending-style] { opacity: 0; transform: scale(0.95); } ``` The `transform-origin` is the whole point — the panel should look like it came out of the thing you clicked. --- ## Tooltip Same shape as a popover, faster, plus the detail most implementations miss. ```css .tooltip { transform-origin: var(--transform-origin); transition: transform 125ms var(--ease-out), opacity 125ms var(--ease-out); } .tooltip[data-starting-style], .tooltip[data-ending-style] { opacity: 0; transform: scale(0.97); } /* Once one tooltip is open, neighbours open instantly */ .tooltip[data-instant] { transition-duration: 0ms; } ``` The initial delay prevents accidental activation. After that, skipping both the delay and the animation makes the whole toolbar feel faster. --- ## Modal The one popover that stays centered. ```css .modal { transform-origin: center; /* exempt — not anchored to a trigger */ transition: opacity 250ms var(--ease-out), transform 250ms var(--ease-out); } .modal[data-starting-style], .modal[data-ending-style] { opacity: 0; transform: scale(0.96); } .backdrop { transition: opacity 250ms var(--ease-out); } ``` Animate the backdrop's opacity alongside it so they read as one surface. --- ## Drawer / sheet ```css .drawer { transform: translateY(0); transition: transform 500ms var(--ease-drawer); } .drawer[data-closed] { transform: translateY(100%); } ``` This is how Vaul hides a drawer before animating it in. Add drag and it becomes a gesture problem — see **Drag to dismiss** below. --- ## Toast ```css .toast { opacity: 1; transform: translateY(0); transition: opacity 400ms ease, transform 400ms ease; @starting-style { opacity: 0; transform: translateY(100%); } } ``` - `ease` rather than `ease-out`, slightly slower than typical UI: Sonner reads as elegant partly because its motion is tuned to the component's personality rather than to the generic UI budget. - If `@starting-style` isn't available, fall back to the mount flag: ```jsx useEffect(() => { setMounted(true); }, []); // <div data-mounted={mounted}> ``` When toasts stack and the list reflows, the opacity change has to work against the height change. There's no formula for that pair — adjust until it feels right, then check it again the next day. --- ## Accordion / collapse ```css .content { overflow: hidden; transition: height 200ms var(--ease-out), opacity 200ms var(--ease-out); } ``` Keep it short — this is one of the few animations that costs layout on every frame, so a long duration is expensive as well as sluggish. Measure the content height in JS (or use a headless primitive that supplies it) rather than animating to `auto`. --- ## Stagger a group entrance For a list or grid the user sees occasionally — not for a list they scroll past all day. ```css .item { opacity: 0; transform: translateY(8px); animation: fadeIn 300ms var(--ease-out) forwards; } .item:nth-child(2) { animation-delay: 50ms; } .item:nth-child(3) { animation-delay: 100ms; } .item:nth-child(4) { animation-delay: 150ms; } @keyframes fadeIn { to { opacity: 1; transform: translateY(0); } } ``` Stagger is decorative — it must never block interaction while it plays. --- ## Hold to confirm For destructive actions where a plain click is too easy to fire by accident. ```css .overlay { clip-path: inset(0 100% 0 0); transition: clip-path 200ms var(--ease-out); /* release: snappy */ } .button:active .overlay { clip-path: inset(0 0 0 0); transition: clip-path 2s linear; /* press: slow and deliberate */ } .button:active { transform: scale(0.97); } ``` `linear` is correct here — the fill is a progress indicator, and progress shouldn't ease. --- ## Tab indicator with a color transition Timing individual color transitions across a tab list never quite lands. Clip instead. Duplicate the tab list. Style the copy as the active state — different background, different text color. Clip the copy so only the active tab shows, and animate the clip on change: ```css .tabs-active-copy { clip-path: inset(0 60% 0 20%); /* driven by the active tab's position */ transition: clip-path 250ms var(--ease-in-out); } ``` The text and background change together, in perfect sync, because they're one element being revealed rather than two colors being interpolated. --- ## Scroll reveal Marketing surfaces only. Don't do this to functional UI a user visits daily. ```css .reveal { clip-path: inset(0 0 100% 0); transition: clip-path 600ms var(--ease-in-out); } .reveal[data-visible] { clip-path: inset(0 0 0 0); } ``` Trigger with `IntersectionObserver`, or Motion's `useInView` with `{ once: true, margin: "-100px" }`. Fire it once — re-animating on every scroll-by is an interface fighting its reader. --- ## Drag to dismiss The gesture recipe. Springs, not durations, because the user can reverse mid-motion. ```js // Dismiss on a flick, not just on distance const timeTaken = Date.now() - dragStartTime.current; const velocity = Math.abs(swipeAmount) / timeTaken; if (Math.abs(swipeAmount) >= SWIPE_THRESHOLD || velocity > 0.11) { dismiss(); } ``` ```js // Set transform on the dragged element directly. // Driving it through a CSS variable on the parent recalcs styles for every child. element.style.transform = `translateY(${distance}px)`; ``` Four details that separate a good drag from a bad one: - **Pointer capture** once the drag starts, so it continues when the pointer leaves the element's bounds. - **Multi-touch protection** — `if (isDragging) return` on new touch points, or switching fingers mid-drag makes the element jump. - **Damping past boundaries** — dragging beyond a natural edge moves the element less the further it goes. Real things slow before they stop. - **Friction, not a wall** — allow the over-drag with rising resistance rather than refusing it. Settle with a spring so an interrupted drag keeps its velocity: ```js { type: "spring", duration: 0.5, bounce: 0.2 } ``` --- ## Masking a crossfade that won't settle When two states overlap visibly during a transition and no amount of easing or duration tuning fixes it, blur the seam: ```css .content { transition: filter 200ms ease, opacity 200ms ease; } .content.transitioning { filter: blur(2px); opacity: 0.7; } ``` Without blur the eye reads two distinct objects swapping. Blur blends them into one perceived transformation. Keep it under 20px — heavy blur is expensive, especially in Safari. --- ## Programmatic, without a library When the motion needs JS control but not a dependency, WAAPI gives you CSS-grade performance: ```js element.animate( [{ clipPath: 'inset(0 0 100% 0)' }, { clipPath: 'inset(0 0 0 0)' }], { duration: 1000, fill: 'forwards', easing: 'cubic-bezier(0.77, 0, 0.175, 1)' } ); ``` Hardware-accelerated, interruptible, no bundle cost.README.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/emilkowalski-skills-skills-animate.md