Better Motion is an agent skill that starts by asking whether an element should move at all, and often answers no. When motion is right, it supplies the numbers: duration by element size, ease-out for state changes, springs with zero bounce for things with weight, a 0.96 press scale and short exits.
It covers CSS transitions and the Motion library, including AnimatePresence modes, shared layoutId animation, measured height and snapping drag. It keeps the project’s own motion tokens and curves wherever a deliberate convention exists.
What You Get
- A duration table by element size, with exits shorter than enters, plus exact scale, distance and transform-origin rules for popups, modals and sheets
- Spring settings written as a duration with bounce zero, and a CSS cubic-bezier stand-in where no motion library exists
- Recipes for staggered entrances, exit animations, icon cross-fades, shared layoutId transitions, animated height and snapping drag
- Reduced-motion gating for CSS, Tailwind and Motion, and a theme-switch transition suppression recipe
- A slow-motion replay step and a detection table with fixes for patterns such as transition all and unkeyed AnimatePresence children
Common Use Cases
- Adding enter and exit animation to a dropdown, tooltip or modal with correct origin and distance
- Swapping an icon between states, such as copy to copied, with a cross-fade
- Animating a container whose content changes height
- Reviewing existing animations for transition all, keyframes on toggled state or springs on color changes
What Makes It Unique
It treats removing an animation as a valid fix and separates exact values from starting points. The press scale, icon cross-fade, stagger and spring bounce are exact, while the duration, scale and distance tables are desktop starting points to adjust by eye. It also requires replaying each animation at a tenth of its speed before calling it done.
Under The Hood
The skill is a SKILL.md with eight reference files covering transitions, enter and exit, icon transitions, layout animation, drag, performance, slow motion and reporting. It contains no scripts. The agent reads your components and styles, and in a browser it walks each state, reverses it mid-flight and replays it slowed down. A review leaves files untouched, and code changes happen when you ask for them.