Skip to content

TheGoat395/Codex-Skills / skills/motion-language-director

motion-language-director

Verified

Direct choreography and Viktor-style pacing.

FileKindSize
SKILL.mdskill md766 B
agents/openai.yamlconfig246 B
references/motion-language-director-guide.mdmarkdown2.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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall