motion-design
Design and build UI motion with intent — micro-interactions, transitions, entrances, scroll and hover behavior — applying the twelve principles of animation to a brand's settled system, in custom code. Use when the user mentions 'animation,' 'motion,' 'micro-interactions,' 'hover effect,' 'transition,' 'scroll animation,' 'page-load animation,' 'make it feel alive,' 'the interactions feel off,' 'add motion,' 'easing,' or 'why does this feel cheap/janky.' This is where a static surface becomes something that moves with weight, emotion, and restraint — not fade-up-on-everything.
zstvns · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add zstvns/design-skills --skill motion-designAbout this skill
name: motion-design description: "Design and build UI motion with intent — micro-interactions, transitions, entrances, scroll and hover behavior — applying the twelve principles of animation to a brand's settled system, in custom code. Use when the user mentions 'animation,' 'motion,' 'micro-interactions,' 'hover effect,' 'transition,' 'scroll animation,' 'page-load animation,' 'make it feel alive,' 'the interactions feel off,' 'add motion,' 'easing,' or 'why does this feel cheap/janky.' This is where a static surface becomes something that moves with weight, emotion, and restraint — not fade-up-on-everything." metadata: version: 1.6.1
Motion Design
You design and build UI motion — and you build it in custom code. Motion is not decoration sprinkled on a finished page; it is the arrangement of time the same way layout is the arrangement of space. Done right it gives a surface weight, emotion, and life, and keeps a person on the page. Done wrong it is the single loudest tell of an amateur build.
Read design-principles first. Everything here is that philosophy in the time dimension: hierarchy (not everything moves, and not equally), restraint (protect the few motions that carry meaning by cutting the ones that compete), emotion before execution (know the feeling before you pick the easing), and defaults-not-laws (every animation earns its place with a reason, or the default — no motion — stands).
Position in the sequence: an Application skill, sibling to
web-design.web-designships the surface with a light motion floor and defers the real motion craft — expressive easing, timing, choreography — to here. Motion applies to a built, structurally-sound artifact; it does not invent one. It consumes the system's motion character; it does not define the system.
Front-Door Diagnosis — Is There Anything to Animate Yet?
Motion is the last layer. Before adding a single transition, confirm two things:
- The artifact is structurally sound. Proper markup, real hierarchy, working layout, real copy in place. If the layout is still moving, don't animate it — you'll polish motion onto something that's about to change. Route back to
web-design(or whichever Application skill built the surface). - The visual system is settled and its motion character is known. Open
.agents/design.md. A brand has a motion feel the same way it has a color and a type feel — playful and springy, or calm and premium, or precise and mechanical. That feeling traces to the emotional target and the muses (creative-direction). If the system is being defined or reworked (Revolution / heavy Evolution), route back tocreative-direction— motion character is part of the identity, not something you invent at the end.
The rule of thumb mirrors web-design: proceed only when the surface is built and the system is settled. Otherwise, go back.
Motion Is Emotion — the Core Insight
It's in the word: e-motion. Motion is not a finishing layer applied to a design — it is one of the most direct carriers of feeling the brand has. The proof is counterintuitive: the same element, animated two different ways, communicates two entirely different things. A button with a fast springy overshoot reads fun and loose; the identical button scaling up slowly and settling reads premium and serious. You have not changed the pixels — you changed the time, and the feeling flipped.
Two levers do most of that work at the element level:
- Speed encodes cost. Fast is snappy, casual, inexpensive. Slow is deliberate, luxurious, expensive — a thing that takes its time because it's serious.
- Size sets pace. Small things move fast; big things move slow — a mouse scurries, an elephant lumbers. A tiny toggle that eases lazily feels broken; a full-screen panel that snaps feels cheap. Match duration to the mass of the thing moving.
So before you touch the easing, ask what design-principles asks of every choice: what should this feel like? The answer picks your timing and your curve. And that answer is not yours to invent — it comes from the brand.
Motion Character Is Brand-Derived — Calibrate the Whole System First
How motion is executed is contingent on the brand being built. Motion character is part of the identity, defined in creative-direction and traceable to the emotional target and the muses in .agents/design.md / .agents/brand.md. Two brands can apply every principle in this skill correctly and end up with motion that looks nothing alike — and both be right.
Before animating anything, set the system-level dial, not just per-element curves. Four things vary by brand:
- Easing personality — how strange the curves are allowed to be. Springy, elastic, overshooting, even sporadic and irregular at the playful end; smooth, controlled, near-symmetrical at the serious end.
- Amplitude — how grandiose a given move is. Big travel, big scale, showy multi-property transforms vs. small, tight, minimal displacement.
- Frequency & coverage — how much of the surface moves at all, and how often. A playful brand may animate many things, including small ones that a serious brand would leave perfectly still.
- What earns motion — a playful brand will spend motion on delight for its own sake; a serious brand spends it almost exclusively on function (feedback, orientation, explanation).
Two poles to calibrate against — most brands sit somewhere between:
| Creative · fun · eccentric · playful | Serious · premium · precise | |
|---|---|---|
| Easing | springy, elastic, overshoot; irregular curves welcome | smooth, controlled, restrained; little or no overshoot |
| Amplitude | grandiose, generous travel and scale | subtle, tight, minimal |
| Frequency | frequent — including on small elements | sparing — reserved for moments that matter |
| Motive | delight is a legitimate reason on its own | motion mostly justifi |