AgentKit
DocsKitsCLI ReferenceDesktop App

Skills

Craft brand-aligned motion with ak:motion-design

Design emotionally-driven, technically sound UI animations — Motion Personality archetypes, Disney principles adapted for UI, timing and easing tables, and multi-element choreography — implementation-agnostic.

Use ak:motion-design when you are creating animations, transitions, micro-interactions, loading states, hero or CTA motion, page transitions, or scroll-triggered effects and want a decision framework that stays faithful to brand personality without inventing physics.

Choose ak:motion-design for animation intent

Use ak:motion-design when

  • You are creating UI animations — buttons, cards, modals, page transitions.
  • You need to design a micro-interaction or feedback animation.
  • You are building a loading, success, or error state.
  • You are animating an illustration or decorative element.
  • You are planning scroll-triggered or progress-based animation.
  • You need to establish a brand motion identity.
  • You are choreographing a multi-element sequence.

Choose another Skill when

  • You want to route a motion or video request to the right skill. Use ak:motion-graphics.
  • You want to design a banner or a static visual. Use ak:banner-design or ak:design.
  • You want programmatic React video or GLSL — install the Engineer Kit and reach for ak:remotion or ak:shader there.

Three pillars

Every animation must satisfy three pillars before any technical decision:

PillarQuestionDrives
Emotional intentWhat should the viewer feel?Easing, timing, amplitude
Visual narrativeWhat is the micro-story?Setup → Action → Resolution
Motion craftHow is it believable?Physics, secondary motion, paths

Every animation has three motion layers. A flat animation is one that missed a layer:

  • Primary — the main action the viewer follows.
  • Secondary — supporting richness (shadows, icons shifting).
  • Ambient — background life (gradients, subtle pulses).

Motion Personality

Pick one archetype per project and apply it consistently.

ArchetypeDurationEasingOvershootKeywords
Playful150–300 msease-out-back10–20 %fun, whimsical, bouncy
Premium350–600 mscubic-bezier(0.4, 0, 0.2, 1)0 %elegant, minimal, luxury
Corporate200–400 mscubic-bezier(0.2, 0, 0, 1)0–3 %clean, professional
Energetic100–250 msease-out-expo15–30 %dynamic, bold, exciting

Default: Corporate for UI, Playful for illustrations.

Brand motion identity — define three constants:

  1. A signature easing curve for 80 % of animations.
  2. A duration palette of three (quick, standard, slow).
  3. One consistent entrance pattern.

Eight-step animation checklist

Before creating any animation:

  1. Emotional target — joy, calm, urgency, elegance.
  2. Motion Personality — one archetype per project.
  3. Primary property — position, scale, rotation, opacity.
  4. Duration — see the personality table.
  5. Easing family — entrance decelerates, exit accelerates.
  6. Hero element — apply staging principles.
  7. Secondary and ambient layers — add richness deliberately.
  8. 1/3 rules — motion distance, simultaneous elements.

Property selection

Use the minimum properties needed. One property is direct; two is polished; three or more risks overwhelming the viewer.

Effect goalPrimarySecondary
Entrance / exitpositionopacity, scale
Emphasis / attentionscalerotation (subtle), opacity pulse
State changeopacity, colorscale (press feedback)
Direction / flowpositionrotation (follow path)
Depth / 3D feelscale + shadowposition (parallax)
Loading / progressrotation (spinner)scale, opacity pulse
Successscale (pop)color, rotation (checkmark draw)
Error / alertposition (shake)color, rotation (wobble)

Implementation-agnostic

The Skill works with CSS, Framer Motion, GSAP, Lottie, Spring, or Remotion. It supplies the decision framework and reference tables; the target stack supplies the syntax.

Attribution

Vendored from LottieFiles/motion-design-skill under MIT. Deep-dive references (director, patterns, reference tables) ship with the Skill installation.