TheGoat395/Codex-Skills / skills/motion-language-director
motion-language-director
VerifiedDirect choreography and Viktor-style pacing.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 766 B |
| agents/openai.yaml | config | 246 B |
| references/motion-language-director-guide.md | markdown | 2.7 KB |
references/motion-language-director-guide.md
View on GitHub# Motion Language Director Guide
## Purpose
Make animation feel choreographed, purposeful, and appropriate to the brand.
## Use When
- The user asks for animation, motion, cinematic, Framer-like, Viktor-style, scroll effects, GSAP, Lenis, or interactive polish.
- A site needs hover, reveal, page, or scroll motion direction.
- Before choosing GSAP/Motion/Lenis/R3F for a build.
## Do Not Use When
- The UI is a dense utility surface where motion should be minimal.
- The user asks for no animation or strict reduced-motion behavior only.
## Discovery Questions
- What should motion communicate: sequence, depth, focus, state, tactility, speed, drama?
- What motion mood fits: calm, cinematic, crisp, mechanical, liquid, editorial, playful?
- Which library is actually needed: CSS, Motion, GSAP, Lenis, R3F?
- What is the reduced-motion fallback?
## Decision Tree
- If simple hover/state, use CSS first.
- If React component lifecycle/layout transitions, use Motion.
- If scroll choreography/timelines/pinning/masks, use GSAP and available GSAP guidance verified in the installed skill catalog or current official documentation.
- If smooth scroll supports cinematic flow, consider Lenis with accessibility caution.
- If depth/material/space is core, consider R3F/WebGL.
## Implementation Rules
- Define timing, easing, stagger, distance, and purpose before coding.
- Use fewer stronger sequences instead of identical fade-ups everywhere.
- Animate transform, opacity, clip/mask, and shader uniforms before layout properties.
- Never gate content visibility solely on JS-triggered reveal.
- Respect prefers-reduced-motion.
## Useful Patterns
- Luxury: slow clip/fade, subtle parallax, low frequency, quiet easing.
- Productivity/devtool: snappy state changes, crisp hovers, command-like speed.
- Cinematic: pinned scenes, layered depth, text reveals, scroll camera feeling.
- Portfolio: gallery hover, page transitions, project reveal rhythm.
## Anti-Patterns
- Bounce/elastic defaults for serious premium sites.
- Same scroll reveal on every section.
- Scroll hijacking that traps the user.
- Animations that produce jank or content invisibility.
## QA Checklist
- Check reduced-motion behavior.
- Check performance and console errors.
- Check mobile scroll/gesture experience.
- Confirm motion supports hierarchy and does not obscure content.
## Acceptance Criteria
- Every motion choice has a purpose and fallback.
- The animation system feels consistent with the site category.
## Scoped execution
Apply the [shared web contract](../../website-operating-rules/references/scoped-web-contract.md) once when execution crosses phases; reuse it if already read. Load only the specialist guidance relevant to the requested surface and deliverable.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |