Find animation opportunities
Find high-value motion by exercising restraint. A result with no surviving opportunities is valid; daily-use product UI usually benefits from less motion.
Triggers
- Use when asked what should animate, where motion would improve an otherwise static interface, or which proposed motion ideas are worth pursuing.
- Do not use to fix current animations, review a motion diff, or implement the recommendations; route those follow-ups to the existing motion skills.
Authority and boundaries
- Read
docs/ai/rules/frontend.md, thendocs/ai/skills/emil-design-engineering/SKILL.mdanddocs/ai/skills/anim/SKILL.mdbefore judging a surface. - Core's tokens, Base UI primitives, shared utilities, route-transition boundary, touch gates, and reduced-motion baseline override generic examples.
- Use
improve-animationsto audit or plan fixes for existing motion andreview-animationsonly for an explicitly requested motion-diff review. Usemotionlater if an approved implementation needsmotion/reactdetails. - This skill reports evidence and recipes only. Do not edit source, write plan files, install tooling, or change dependencies while it is active.
Candidate gate
Every recommendation must pass all five checks:
- Frequency and input: Reject decorative motion on keyboard-initiated, high-frequency, or information-dense interactions. Frequent feedback may use an existing near-imperceptible Core utility; it is not a new opportunity.
- Purpose: Name one purpose: feedback, spatial continuity, state clarity, preventing a jarring change, explanation, or rare delight. “Looks cool” fails.
- User value: Motion must make cause/effect, hierarchy, progress, or state easier to understand. It must not delay access to content or action.
- Existing ownership: Reject motion already supplied by
Button, Base UI overlays, shared hover/press utilities, orRouteMainViewTransitionBoundary. Never stack a second entrance or hover grammar on top. - Core feasibility: The recipe must use existing motion tokens/presets, avoid layout-driving properties, remain interruptible where state can reverse, preserve reduced-motion behavior, and gate hover motion to fine pointers.
Workflow
- Recon. Define the route/component scope, product personality, input methods, frequency, current motion owners, and performance/accessibility constraints. Inspect a running UI when available; otherwise state the limits of code-only evidence.
- Sweep seams. Look for abrupt occasional state changes, unclear spatial relationships, missing progress/feedback, rare empty/success/onboarding moments, and gesture transitions. Also inspect the places most likely to be over-animated so the report contains meaningful rejections.
- Gate candidates. Re-read every cited location and apply all five checks. Reject duplicates, speculative ideas, and anything already intentional.
- Specify survivors. Report at most five opportunities, ordered by leverage. Name the existing Core token, preset, utility, or primitive to reuse. Do not invent literal durations, easings, scales, or a parallel motion system.
- Report restraint. Include two to five rejected candidates and the exact gate that rejected each. If nothing survives, say that the interface should remain as-is.
High-value seams
- Occasional content or status that appears, disappears, or swaps abruptly.
- A panel or object whose origin/destination is unclear and is not already owned by a Base UI primitive or the shared route-transition layer.
- Progress or completion feedback where motion would clarify causality.
- Rare first-run, empty, success, or celebration moments that earn delight.
- Gesture-driven surfaces that need continuity, interruptibility, or momentum.
Usually reject command palettes, keyboard shortcuts, dense tables, live charts, routine list navigation, page-load choreography, blanket scroll reveals, and decorative movement on data users are reading. Shared buttons already have press feedback; shared overlays and routes already have their own motion grammar.
Required report
Opportunities
| # | Location | Current seam | Purpose | Frequency | Core-compatible recipe |
|---|
Each row needs exact file:line evidence and an existing Core mechanism. Mark
anything requiring a live feel-check rather than pretending code proves taste.
Rejected candidates
| Location | Candidate considered | Rejection gate | Why static is better |
|---|
Verdict
State how much motion the surface actually needs, the highest-leverage survivor
if one exists, and whether a follow-up improve-animations plan <description>
would be warranted.
Checklist
- The inspected scope, frequency, inputs, and current motion owners are clear.
- Every survivor passes purpose, value, ownership, and feasibility gates.
- Recommendations reuse Core tokens/primitives without duplicate motion.
- Performance, touch, keyboard, reduced motion, and interruptibility are covered.
- The report has at most five opportunities plus explicit rejected candidates.
- Findings cite exact files/lines and distinguish code evidence from feel checks.
- No source, plan, dependency, or runtime file changed during the inspection.
Provenance
See references/upstream.md for the reviewed upstream source, MIT license, Core adaptations, and refresh workflow.
