In the Skill's Own Terms
find-animation-opportunities is a read-only search skill for a codebase or UI: it sweeps an interface for moments that would genuinely benefit from motion and proposes a precise recipe for each, with exact curves, durations and properties, but never implements it. Its defining trait is restraint.
The premise is "You Don't Need Animations": an opportunity finder that suggests motion everywhere produces the sluggish, over-animated interfaces this repo exists to prevent. So it is a filter as much as a finder, expecting to reject most candidates. Every candidate must survive four gate questions — frequency, purpose, speed, function — and output is capped at 5–7 suggestions for a whole app, ordered by leverage.
What it produces
- An opportunities table: one row per surviving suggestion with location, today's behaviour, purpose, frequency tier and the suggested motion with exact values.
- A rejected candidates section listing 2–5 places deliberately left out, each tagged with the gate question that killed it.
- A short verdict paragraph naming the highest-leverage suggestion and pointing at the handoff command improve-animations plan to turn any row into an implementation plan.
How It Works
- 01Recon the Stack and Its Tokens
Identify the stack, motion libraries, existing easing and duration tokens and the product's personality, so suggestions extend what the project already uses instead of inventing parallel values.
- 02Sweep the Known Seams
Work through the hunt list of seam classes — feedback gaps, teleporting state, missing spatial story, group entrances, gesture seams, the delight budget — rather than eyeballing the UI.
- 03Gate Every Candidate
Each survivor has to answer all four questions in order: frequency, purpose, speed, function. The skill is meant to be ruthless here, and most candidates fail.
- 04Report in Three Parts
Write the opportunities table, the rejected candidates and the verdict. An empty result is acceptable and should be stated plainly rather than padded.