OpenParable
Skip to content
← Back to skills

Motion Choreography

Design
motion-choreography

Motion Choreography is an Agent Skill for design published in the Owl-Listener/designpowers repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when designing animation sequences, page transitions, micro-interactions, loading states, or any motion that communicates meaning — ensures motion is purposeful, performant, and safe for motion-sensitive users

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Owl-Listener/designpowers/blob/HEAD/skills/motion-choreography/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/motion-choreography, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Motion Choreography

Motion is communication. Every animation answers a question the user didn't know they had. If it doesn't answer one, cut it.

The Three Questions

Before adding any animation:

  1. What changed? — the animation makes it visible
  2. What should I look at next? — directs attention
  3. How are these related? — shows spatial/hierarchical relationship

Can't answer at least one? The animation is decoration. Cut it.

Duration Guide

ContextDuration
Micro-interaction (button, toggle)100-200ms
State change (card expand, tab)200-300ms
Screen transition250-400ms
Complex choreography400-700ms total

Nothing over 1 second unless it's a loading indicator.

Easing Reference

ContextEasing
Enteringease-out (decelerate)
Leavingease-in (accelerate)
State changeease-in-out
Micro-interactionspring (stiffness 300-500)

Stagger Patterns

  • 50-80ms delay between items
  • Maximum 5 items staggered, rest appear instantly
  • Follow reading order
  • Reveal hierarchy — important items first

Reduced Motion

prefers-reduced-motion: reduce means reduce, not remove.

StandardReduced alternative
Slide inFade in
Scale with bounceInstant appearance
Parallax scrollStatic
Staggered revealSimultaneous fade
Continuous pulseStatic state

Every animation must have a reduced-motion alternative. No exceptions.

What NOT to Animate

  • Text colour changes (photosensitive risk)
  • Layout properties in performance paths (use transform)
  • Anything that delays task completion
  • Decorative loops without user control

Performance

Only animate: transform, opacity, filter. These are GPU-composited.

What You Deliver

  • Animation specs with durations, easings, triggers
  • Reduced-motion alternatives for every animation
  • Performance annotations
  • Sequence diagrams for complex choreography

Integration

  • Informed by: design-lead, interaction-design
  • Feeds into: motion-designer agent, accessibility-reviewer, design-builder