motion
Designs and specifies motion for interfaces, websites, brands, video and displays: purpose, the 12 animation principles, duration and easing tokens, springs, choreography, brand motion language, kinetic type, CSS, View Transitions, GSAP, Motion, Lottie, Rive, After Effects, Remotion renders, token-built Lottie, export specs, captions, loudness and UI sound, with reduced-motion and flash safety. Use when animating UI, choosing durations or easing, building a motion system, making an ident, social or explainer video, kinetic type, Lottie or Rive assets, or sound.
- License 许可
- MIT
- 最近更新
- 2026-11-10
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- motion
- license
- MIT
- metadata
- { "agent-attribution": "computer=vm; tool=Claude Code; version=2.1.318; timestamp=2026-11-05 18:10:00 UTC", "version-timestamp": "2026-11-05 18:10:00 UTC" }
- description
- Designs and specifies motion for interfaces, websites, brands, video and displays: purpose, the 12 animation principles, duration and easing tokens, springs, choreography, brand motion language, kinetic type, CSS, View Transitions, GSAP, Motion, Lottie, Rive, After Effects, Remotion renders, token-built Lottie, export specs, captions, loudness and UI sound, with reduced-motion and flash safety. Use when animating UI, choosing durations or easing, building a motion system, making an ident, social or explainer video, kinetic type, Lottie or Rive assets, or sound.
02 资源文件 11
- 参考文档references/choreography.md7.5 KB
- 参考文档references/kinetic-typography.md7.9 KB
- 参考文档references/lottie-and-rive.md9.4 KB
- 参考文档references/motion-specimen.html19.1 KB
- 参考文档references/motion-system.md9.9 KB
- 参考文档references/principles.md9.5 KB
- 参考文档references/production-pipeline.md10.9 KB
- 参考文档references/sound.md8.5 KB
- 参考文档references/timing-and-easing.md11.2 KB
- 参考文档references/video-and-motion-graphics.md11.5 KB
- 参考文档references/web-implementation.md14.3 KB
03 SKILL.md 正文
Motion
Excellent motion is felt more than seen: every movement has a job (feedback, orientation, focus or expression), uses the brand's small set of durations and curves, never blocks the user, and degrades gracefully to stillness. Spectacle is reserved for the few moments that earn it.
Defaults
| Decision | Default | Move off it when |
|---|---|---|
| Purpose | Every animation names its job: feedback, orientation, focus or expression | No job: cut it |
| Durations | --duration-fast 120ms (micro), --duration-moderate 200ms (small), --duration-slow 320ms (medium), --duration-slower 480ms (large surfaces, pages) |
Calm brands 20-25% shorter; luxury and expressive brands up to 25% longer |
| UI ceiling | Chrome at 480ms or less; brand moments up to 3s and skippable | Never for repeated actions |
| Easing | Enter --ease-decelerate or --ease-emphasized-decelerate; exit --ease-accelerate; move --ease-standard; --ease-linear only for opacity loops, progress and scroll scrubbing |
Brand language adds overshoot or springs |
| Enter and exit | Exit 20-35% shorter than enter (one token step) | Exit and re-enter loops that must match |
| Latency | Feedback starts within 100ms of input; input is never blocked by animation | None |
| Properties | transform and opacity; never transition: all |
Color and filter for small elements, after measuring |
| Stagger | 20-50ms per item; the last item starts within 300ms; entrances only | Editorial moments up to about 1.2s total |
| Springs | For gestures and interruptible movement; bounce 0 (calm) to 0.3 (playful), set explicitly | Coordinated timelines use bezier tokens |
| Reduced motion | Tokens drop to 0.01ms automatically; replace spatial movement with an opacity fade of 200ms or less, or an instant change | Essential motion (a video the user started) |
| Loops and flashes | Anything auto-moving for more than 5s gets pause, stop or hide (WCAG 2.2.2); no more than 3 flashes per second (2.3.1) | None |
| On-screen text | Hold for 1s + words ÷ 3 seconds, at least 1.5-2s, once fully legible | Add 50% for numbers, legal text and second-language audiences |
| Video delivery | Source frame rate; ProRes 422 HQ master; H.264 1080p at 8-12 Mbps; streaming and social loudness about -14 LUFS, EBU R128 -23 LUFS, ATSC A/85 -24 LKFS | The platform or broadcaster spec sheet |
| Production engine | CSS or GSAP for UI; portable Lottie for icons, loaders and stings; Remotion for data-driven or many-variant video; After Effects for hand-animated spots | Remotion at 4+ people (contractors count) needs a Company License |
| Deliverable stills | Every moving file ships a poster frame (the last or most meaningful frame), used as the reduced-motion fallback | None |
| Sound | Off by default on the web; never the only carrier of information; UI sounds 50-300ms | Games, music products and kiosks with an agreed brief |
Workflow
- Read the brief for motion variables: medium (product UI, website, video, display), audience, style, archetype, industry, channel and platform. Run the atlas query below and read the Motion section of each selected style.
- Set the personality: place the brand on the calm-to-energetic spectrum and fix the token values (motion system).
- List the moments: every state change, transition and brand moment, with its purpose (principles). Cut anything without a purpose, and anything a user sees 100+ times a day that is not 150ms or less.
- Specify each moment: trigger, properties, duration token, easing token, choreography, interruption behavior and reduced-motion alternative (timing and easing, choreography). Use the motion specification template for client work.
- Choose the medium and engine: CSS, WAAPI, View Transitions, GSAP or Motion (web implementation); Lottie or Rive (Lottie and Rive); After Effects or Remotion (video and motion graphics). For finished files, follow the production pipeline: map tokens into the engine, build Lottie with
lottie_build.pyand check it withvalidate, start video from the Remotion example, and check the Remotion license. - Build the riskiest moment first: the page transition, the hero ident or the most-used interaction, wired to tokens.
- Render and inspect: play at 1x and at 0.25x, and screen-record at 60fps to step through frames. Check reduced motion, a phone, keyboard use and interruption (click twice quickly). For video, watch full playback on the target player, check loop seams three times, run a flash check (3 per second at most), meter loudness, check caption timing and safe areas, and render poster stills. Without subagents or a renderer, do these checks yourself in one pass and list what was not rendered.
- Measure: frame timing in DevTools at 4x CPU throttle, INP and CLS, transferred bytes for Lottie, Rive and video.
- Document and hand off: the pattern table and token mapping (motion system), the Lottie and Rive handoff checklists, and export specs. Compare against the motion specimen.
Decisions that change the answer
Motion personality depends on style and archetype first, then audience, industry and channel:
python3 ../../library/scripts/atlas.py query "luxury skincare calm sensual"
python3 ../../library/scripts/atlas.py show style.classic-luxury-serif
python3 ../../library/scripts/atlas.py combine style.playful-bubbly archetype.jester audience.older-adults
- Style:
style.swiss-internationalis precise (160-240ms, standard easing, no bounce);style.playful-bubblyis springy (bounce 0.3-0.45, squash and stretch on icons);style.classic-luxury-serifis slow (400-700ms reveals, expo-out, long crossfades);style.neo-brutalistis abrupt (instant swaps, hard offsets). The full table is in motion system. - Archetype: sets tempo and energy (
archetype.rulercontrolled,archetype.herofast and forceful,archetype.jesterbouncy,archetype.caregivergentle). - Audience: caps amplitude.
audience.older-adults,audience.neurodivergentandaudience.disability-accessibility-firstget lower amplitude, fewer loops and an in-app motion setting.audience.children-under-13can be bouncier but must never flash. - Industry and flow: money, health and security flows stay calm whatever the brand energy.
- Channel:
channel.web-appandchannel.native-appare dominated by feedback and orientation;channel.marketing-websiteadds expression;channel.video-motionandchannel.social-mediaadd kinetic type, holds, safe areas, captions and loudness;channel.ooh-signageruns on hold times and silent comprehension. - Platform: desktop runs 20-30% faster than phone and tablet slower; iOS favors springs; Android follows Material 3 tokens.
- Market: mirror direction for right-to-left scripts; 25fps in PAL-heritage regions and 30fps in NTSC-heritage regions; broadcast loudness follows EBU R128 or ATSC A/85.
- Tier: luxury slows down and removes bounce; value tiers favor fast, functional motion.
Common failures
- Same 300ms ease on everything, so nothing has hierarchy. Use the four duration steps and pick the curve by enter, exit or move.
- Every section fades up on scroll. Reveal only meaningful content, once, in hierarchy order.
- Animations that block input or cannot be interrupted. Accept input immediately and reverse from the current value.
- Reduced motion handled by deleting all feedback. Replace movement with a short fade or an instant state change.
- Bounce on enterprise tables and payment flows. Match personality to style and flow criticality.
- Animating
width,toporbox-shadowand dropping frames. Use transforms, opacity and FLIP. - Kinetic text that never holds still. Hold the complete line for at least 1s + words ÷ 3.
- Lottie files with embedded rasters and unsupported effects. Check the support matrix and the size budget before animating.
- Video mastered loud and clipped, or captions colliding with platform UI. Meter to the destination target and design inside the safe zone.
- Sound used as the only signal. Pair every sound with a visual and, where possible, a haptic.
References
- Principles: purposes of motion, the 12 principles in UI and motion graphics, when not to animate.
- Timing and easing: duration tables, easing curves, springs, frame rates and frame counts.
- Choreography: stagger, sequencing, shared elements, transform origin, overload rules.
- Motion system: personality spectrum, atlas style and archetype mapping, tokens, documentation template.
- Kinetic typography: hold times, techniques, legibility, captions, WCAG 2.2.2, 2.3.1 and 2.3.3.
- Web implementation: CSS, WAAPI, View Transitions, scroll-driven animation, GSAP (license verified 2026), Motion, performance, reduced motion.
- Lottie and Rive: export, feature support, dotLottie, players, state machines, data binding, choosing a medium, handoff checklists.
- Video and motion graphics: After Effects rigs and expressions, MOGRT, Remotion, export specs, safe areas, loudness.
- Production pipeline: Remotion vs Lottie vs CSS/GSAP vs After Effects, token mapping, portable Lottie, render and encode presets, accessibility gates, licenses and provenance.
- Asset licenses: Freesound CC0-only and Pixabay rules, Content ID note, optional c2patool content credentials, provenance record per audio file.
- Sound: UI sound, sonic branding, levels, accessibility.
- Motion specimen: live comparison of every duration and easing token.
- Production code: Remotion and Lottie example (six token-driven compositions, posters, encoding presets) and the stdlib Lottie builder (
build,validate,examples). - Web technique recipes: 58 cinematic web recipes (video loops, entrances, split text, scroll stages, 3D) with reduced-motion branches, a WCAG 2.2.2 pause control and pinned GSAP, three.js and motion versions.
- Working code: website motion library, motion and media recipes, Astro motion playground, screen content and motion method card.
- Deep process for client projects: motion effects, web motion library, screen animation, kinetic type, screen video, loops, audio and captions, storyboards, still to motion, screen effects.
Catalog IDs covered: motion, web-motion-library, screen-animation, screen-kinetic-type, screen-video, screen-loops, screen-audio-captions, screen-storyboard, screen-still-motion, screen-effects
04 同仓库更多 Skills
web-design
Load before planning, designing, auditing or launching any website, landing page, cinematic hero, microsite or above-the-fold layout, or a prompt for Lovable, Bolt or v0 to build one, including regulated (prescription drug, health, finance), multilingual or market-specific launches. Covers page types (home, product, pricing, about, blog), conversion and ethical persuasion, responsive and fluid layouts, Core Web Vitals, SEO and structured data, localization and language-law requirements, stack and CMS choice (Astro, Next.js, WordPress, Webflow, Framer) and launch QA.
ux-design
Load before designing or reviewing any flow, form, onboarding, navigation or content for real users, especially low-literacy, older, neurodivergent, child or other specific audiences. Covers research and usability tests, heuristic reviews, personas and jobs to be done, journeys and service blueprints, information architecture, UX laws, SUS, SEQ and HEART metrics, plain language and reading level, and microcopy and error messages.
ui-design
Load before designing or specifying any interface screen or component, even a quick one: forms, tables, navigation, dashboards, onboarding, auth and passkeys, pricing, checkout, search and filters, settings, empty, loading and error states, notifications, consent and age-appropriate flows, and AI chat and agent interfaces, all to WCAG 2.2 AA. Also picks React UI libraries (toasts, drawers, command menus). Gives component specs, state matrices, sizes, density and keyboard and accessibility behavior.
typography
Choose, pair, size and set type for brand, web, app, print, slides, signage and motion: modular scales, fluid clamp() type, measure, leading, tracking, OpenType features, font licensing and web font loading, and multiscript setting for CJK, Arabic, Hebrew, Devanagari and Thai. Use when selecting or pairing fonts, building a type scale or type tokens, fixing weak hierarchy or bad line breaks, setting long-form text or numbers, loading web fonts, or localizing type for another market.
reference-reconstruction
Reconstructs the observed interface and behavior of a supplied app, site or screenshot set using a screen index, measurements, state and command maps, reusable components and matched-condition comparisons. Use when asked to reverse engineer, clone, reproduce or match a reference product, then adapt it if requested.
print-packaging-social
Load before any print, packaging, label, barcode, social, out-of-home, slide-deck or email design question, even a quick one, and before making finished collateral files. Specs: bleed, safe zones, 300ppi, CMYK, PDF/X preflight, dielines, barcodes, social formats with 9:16 safe areas, billboard letter heights, 16:9 decks, bulletproof email. Renders token-driven brand books, sell sheets, cards, carousels and decks to PDF and PNG with a Canva editable twin.