taste-motion
Motion craft for agent-built interfaces: duration and easing tokens, entrance choreography, hover/active micro-interactions, scroll-driven reveals, layout transitions, and prefers-reduced-motion compliance. Prevents the two AI-motion crimes: nothing moves at all, or everything moves forever. Stack on the design-taste core skill.
How do I install this agent skill?
npx skills add https://github.com/madebymustafa/design-taste --skill taste-motionIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a set of design guidelines and CSS tokens for implementing motion and animations in user interfaces. It does not contain any executable code, external dependencies, or network operations, and it follows security best practices for accessible UI design.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
taste-motion
Motion's job is to explain the interface, not decorate it. Every animation must answer: what happened, where is it, what do I do next.
1. THE DURATION SCALE (Fixed Tokens)
| Token | Duration | Use for |
|---|---|---|
--dur-fast | 100–150ms | hovers, pressed states, focus rings |
--dur-base | 200–300ms | small entrances, state changes (toggle, open/close) |
--dur-slow | 400–600ms | section reveals, page-level transitions, dialog open |
--dur-hero | 600–900ms | the ONE hero entrance sequence |
Under 100ms reads as a blink (unless it's a snap, which brutalist packs do deliberately). Over 900ms reads as a slow website.
2. THE EASING TOKENS (Fixed)
- Standard (UI states):
cubic-bezier(0.4, 0, 0.2, 1)— fast in, calm out. Default for hovers and toggles. - Emphasized (entrances/reveals):
cubic-bezier(0.22, 1, 0.36, 1)— long calm tail. Premium feel. - Exit:
cubic-bezier(0.4, 0, 1, 1)or faster — exits are snappier than entrances. - Spring/overshoot (playful packs only):
cubic-bezier(0.34, 1.56, 0.64, 1)— max once per element, never on loops. - Never use
ease-in-outas a catch-all. Never uselinearexcept for marquees/progress.
3. WHAT TO ANIMATE (And What Not To)
Animate: transform and opacity. That's it. 60fps guaranteed.
Never animate: width/height (layout jank — use transform: scale), margin, top/left (use transform), box-shadow at large sizes (use a pre-blurred pseudo-element), filter: blur on large surfaces.
4. CHOREOGRAPHY (Entrances)
- One scene per section: on scroll reveal, the section's elements enter in 2–3 stages (heading → body → CTA), 60–120ms apart, same duration and easing. Stagger is hierarchy.
- Distance ≤ 20px for reveals (translateY 8–16px) + opacity. Bigger distances look like PowerPoint.
- Scale entrances ≤ 0.96→1 and only on dialogs/popovers, never on full sections.
- Hero: one sequence, 600–900ms total, elements entering once. No looping float, no repeating wave.
- Loop allowance: exactly one class of loops allowed per page — ambient status indicators (live dots, loaders, spinners). Everything else loops = error.
5. MICRO-INTERACTIONS (Hover, Press, Focus)
- Hover: 100–150ms, standard easing, one property change (bg tone, border, translateY −1 to −3px). Never both color AND position AND shadow at once.
- Pressed: inverse of hover (translate down, shadow off), 80–120ms.
- Focus-visible: 2px ring, 3:1 contrast,
outline-offset: 2px, animated in with 100ms fade — neveroutline: nonewithout replacement. - Disabled: no hover states at all — the element must look inert (opacity 0.4–0.5, no pointer change).
- Transitions on load/state-change only where the state is visible; a transition nobody can perceive is dead code.
6. SCROLL & LAYOUT
- Scroll-triggered: IntersectionObserver (or CSS
animation-timelinewhere supported), one reveal per element, then done. No elements that re-animate on every scroll pass. - Sticky: allowed for nav and section labels; sticky + animation = performance risk, keep the animation out.
- View transitions / page transitions: 300–500ms, shared-element moves where they earn it (list → detail). Disabled entirely under
prefers-reduced-motion. - Layout transitions:
FLIPpattern (transform-based), never re-layout animations.
7. REDUCED MOTION (Non-Negotiable)
@media (prefers-reduced-motion: reduce) {
*, *::before, *::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}
- Above the CSS gate, zero motion by default when the media query matches: no parallax, no auto-scroll carousels, no marquees.
- Animate presence only: content appears without motion (opacity 0→1 over 1 frame).
8. CHECKLIST (Fail the Page If…)
- Any element animates for more than ~1.5s (outside loops/loaders).
- More than one looping element per viewport.
- Any
width,height,margin, ortopanimation. - Reveal distances beyond 20px.
-
ease-in-outused as the global easing. - Every element on the page animates on load (bounce-entrance festival).
- No
prefers-reduced-motionhandling exists at all.
If you can't explain an animation in one sentence, delete it.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/madebymustafa/design-taste/taste-motion">View taste-motion on skillZs</a>