Build animation
Motion rules are in the UI taste section of ~/agent-skills/working-agreements/AGENTS.md: one
synchronized movement, things travel to their new place, no snaps or visible loop restarts, no
gimmicks, and every animation communicates something.
The feel is the same whatever the style: slow scroll, a single signature living visual, travel
instead of snaps, and still-first heavy visuals. The material and motion character come from a
style add-on in ~/agent-skills/styles/: cinematic.md (weighted camera, plates),
claymorphism.md (springs with squash and give) and glassmorphism.md (a drifting field
under frosted depth). Read the project's chosen add-on first. If none has been chosen, use the
one the user names, or stay neutral.
Choose technology with ~/agent-skills/shared/creative/selector.md (CSS and native APIs
first, one engine per project) and techniques from ~/agent-skills/shared/creative/README.md,
loading only the files you use (scroll choreography, kinetic typography, media reveals,
shared-element and scene transitions, parallax). Motion intensity follows the product
(~/agent-skills/shared/creative/adaptation.md).
Before building a component, interaction or effect, search Arsenal and reuse what fits; register
what you build there (~/agent-skills/shared/creative/arsenal.md). Extra selectable designs
follow ~/agent-skills/shared/creative/design-variants.md.
Pick the path
- Micro-interaction or transition: use the project's motion library or CSS. Animate transform
and opacity only, 150–400 ms, with an ease-out curve and a
prefers-reduced-motion fallback.
Motion and hover never shift layout or change an element's size or position. (high) Motion
never delays critical actions or content, does not replay on small scrolls and never hijacks
scrolling. (high)
- Hover affordance on tiles or cards: follow
workflows/hover-affordance.md (hover glow and
elevation, lift, underline grow, arrow nudge, stretched link, focus parity, reduced motion).
- Signature visual or hero effect: one living element blended into the page with masks, not
boxed. Canvas or WebGL in a single pass, with a devicePixelRatio cap, paused by
IntersectionObserver and
visibilitychange.
- Cinematic landing page: build the page with
build-ui, then choreograph it here with the
cinematic.md add-on, shared/creative/techniques/scroll-choreography.md and
shared/creative/techniques/kinetic-typography.md.
- Reference image of a cinematic scene: follow
workflows/cinematic-plate/cinematic-plate.md
(a generated text-free plate plus live layers; templates and scripts are in that folder).
- Long chaptered page: use the chapter rail and slow scroll in
workflows/chapter-rail.md
(a dot rail of in-page links with a spring-filled line, plus Lenis). The owner likes this pattern.
- WebGL or canvas hero that must stay fast: follow
workflows/heavy-hero-performance.md. It
covers the frame governor, rendering a still plate first and upgrading after input or idle, and
preloading the largest image.
- Isolated heavy effect: delegate the implementation to Codex (UI work, per
~/agent-skills/shared/agent-routing.md) with the coordinate-agents skill, then review it yourself.
- Motion audit: record or screenshot the states, then list snaps, jank, competing motions and
missing reduced-motion handling, each with a fix.
Verify
Follow ~/agent-skills/shared/creative/visual-loop.md and run the audit-design runner (it
measures offscreen and idle rendering, long frames and reduced motion). Check in the running app: frames at the start, middle and end, both themes, and reduced motion on.
Measure frame time with a Performance trace or requestAnimationFrame deltas. For heavy effects,
watch CPU with the page idle and scrolled offscreen.
Reduced motion must react to changes mid-visit. framer-motion's useReducedMotion doesn't, so
use a useSyncExternalStore matchMedia subscription (snippet in workflows/chapter-rail.md). Test
it by toggling page.emulateMedia({ reducedMotion }) after the page has loaded.
1---2name: build-animation3description: "Build calm, continuous 60fps motion that respects reduced motion and pauses offscreen: hero visuals, transitions, scroll choreography, kinetic type, cinematic pages, WebGL/Canvas/SVG effects, cinematic-plate (reference image to live hero). Use for \"add an animation\", \"build motion\", \"cinematic landing page\" or a motion review."4metadata:5 source: https://skillmd.com/skills/amsborse/build-animation6 aliases: "add animation, build motion, build-motion, cinematic landing page, cinematic page, scroll animation, scroll choreography, page transitions, kinetic typography, animate this, hero animation, make it move, motion design, cinematic plate, signature visual, review the animations, hover effect, card hover, tile hover, underline animation, arrow nudge, hover glow"7 keywords: "animation, motion, cinematic, choreography, kinetic, transition, webgl, shader, canvas, svg, three.js, hero, scroll, easing, framer motion"8 composes: "verify, revamp-ui, coordinate-agents, build-ui, build-3d, audit-design"9 requires: "browser, image-generation?, codex-bridge?"10 risk: "low"11---1213# Build animation1415Motion rules are in the UI taste section of `~/agent-skills/working-agreements/AGENTS.md`: one16synchronized movement, things travel to their new place, no snaps or visible loop restarts, no17gimmicks, and every animation communicates something.1819The feel is the same whatever the style: slow scroll, a single signature living visual, travel20instead of snaps, and still-first heavy visuals. The material and motion character come from a21style add-on in `~/agent-skills/styles/`: `cinematic.md` (weighted camera, plates),22`claymorphism.md` (springs with squash and give) and `glassmorphism.md` (a drifting field23under frosted depth). Read the project's chosen add-on first. If none has been chosen, use the24one the user names, or stay neutral.2526Choose technology with `~/agent-skills/shared/creative/selector.md` (CSS and native APIs27first, one engine per project) and techniques from `~/agent-skills/shared/creative/README.md`,28loading only the files you use (scroll choreography, kinetic typography, media reveals,29shared-element and scene transitions, parallax). Motion intensity follows the product30(`~/agent-skills/shared/creative/adaptation.md`).3132Before building a component, interaction or effect, search Arsenal and reuse what fits; register33what you build there (`~/agent-skills/shared/creative/arsenal.md`). Extra selectable designs34follow `~/agent-skills/shared/creative/design-variants.md`.3536## Pick the path3738- **Micro-interaction or transition:** use the project's motion library or CSS. Animate transform39 and opacity only, 150–400 ms, with an ease-out curve and a `prefers-reduced-motion` fallback.40 Motion and hover never shift layout or change an element's size or position. (high) Motion41 never delays critical actions or content, does not replay on small scrolls and never hijacks42 scrolling. (high)43- **Hover affordance on tiles or cards:** follow `workflows/hover-affordance.md` (hover glow and44 elevation, lift, underline grow, arrow nudge, stretched link, focus parity, reduced motion).45- **Signature visual or hero effect:** one living element blended into the page with masks, not46 boxed. Canvas or WebGL in a single pass, with a devicePixelRatio cap, paused by47 IntersectionObserver and `visibilitychange`.48- **Cinematic landing page:** build the page with `build-ui`, then choreograph it here with the49 `cinematic.md` add-on, `shared/creative/techniques/scroll-choreography.md` and50 `shared/creative/techniques/kinetic-typography.md`.51- **Reference image of a cinematic scene:** follow `workflows/cinematic-plate/cinematic-plate.md`52 (a generated text-free plate plus live layers; templates and scripts are in that folder).53- **Long chaptered page:** use the chapter rail and slow scroll in `workflows/chapter-rail.md`54 (a dot rail of in-page links with a spring-filled line, plus Lenis). The owner likes this pattern.55- **WebGL or canvas hero that must stay fast:** follow `workflows/heavy-hero-performance.md`. It56 covers the frame governor, rendering a still plate first and upgrading after input or idle, and57 preloading the largest image.58- **Isolated heavy effect:** delegate the implementation to Codex (UI work, per59 `~/agent-skills/shared/agent-routing.md`) with the `coordinate-agents` skill, then review it yourself.60- **Motion audit:** record or screenshot the states, then list snaps, jank, competing motions and61 missing reduced-motion handling, each with a fix.6263## Verify6465Follow `~/agent-skills/shared/creative/visual-loop.md` and run the `audit-design` runner (it66measures offscreen and idle rendering, long frames and reduced motion). Check in the running app: frames at the start, middle and end, both themes, and reduced motion on.67Measure frame time with a Performance trace or `requestAnimationFrame` deltas. For heavy effects,68watch CPU with the page idle and scrolled offscreen.6970Reduced motion must react to changes mid-visit. framer-motion's `useReducedMotion` doesn't, so71use a `useSyncExternalStore` matchMedia subscription (snippet in `workflows/chapter-rail.md`). Test72it by toggling `page.emulateMedia({ reducedMotion })` after the page has loaded.