motion-library

name	motion-library
description	Use this skill when browsing, comparing, selecting, or applying prebuilt animation and transition references by communication job. Activated by "/motion-library", "/effect", "/apply-motion", "find a transition", "show me effects", or "what animations do we have". Do NOT use the library to force motion into a still-led concept or to choose an effect before its job and constraints are known.

Motion Library Index and Router

WHEN TO USE THIS

• The user explicitly asks to browse or apply an existing effect.
• An approved motion plan names a communication job and needs candidate implementations.
• Existing motion needs comparison against known performance, interaction, or fallback patterns.

NEVER DO

• Never make library consultation a universal creative gate.
• Never select an effect because it looks elite, cinematic, or popular.
• Never let an effect rewrite the approved concept, hierarchy, proof timing, or content.
• Never apply code before checking stack compatibility, accessibility, performance, responsive behavior, and asset requirements.
• Never invent a library entry or claim an implementation was inspected when it was not.

SELECTION PROCESS

1. Name the communication job and the stillness alternative.
2. Record constraints: content, interaction, assets, stack, mobile, reduced motion, performance, and maintenance.
3. Load references/semantic-index.md to identify relevant candidate families.
4. Inspect only the matching files under:
   • ../cinematic-motion/reference/
   • ../cinematic-motion/reference/motion-library/
5. Compare candidates by semantic fit and cost, not spectacle.
6. Recommend adapt, build a simpler custom behavior, or use stillness.
7. Apply an effect only when implementation is authorized and the selected reference has been read.

If the request is vague, present a short curated list grouped by communication job. If it is specific, explain why the candidate fits before implementation.

REFERENCE LOADING RULES

Load references/semantic-index.md for job-to-family routing. Then load only the exact cinematic-motion reference needed for the selected candidate. Directory listings are discovery evidence, not implementation instructions.

OUTPUT SHAPE

Browse: Motion job -> constraints -> candidate families -> tradeoffs -> recommendation.

Apply: Selected reference -> semantic fit -> implementation changes -> fallbacks -> verification.

NON-NEGOTIABLE CHECKLIST

1. Communication job is named before an effect.
2. Stillness was considered.
3. The exact reference was inspected.
4. Concept and content remain in control.
5. Mobile, reduced-motion, performance, and maintenance are addressed.