From d4728061a9fcb987adde753c42a3011edd03c94f Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 14 Oct 2026 23:16:56 +0000 Subject: [PATCH 1/4] Add motion-design skills from iart-ai/motion-design-skills Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_013TAaJBzbmePTECuv62BXYX --- .agents/skills/after-effects/README.md | 0 .agents/skills/after-effects/SKILL.md | 84 ++++++ .../references/export-recipes.md | 168 +++++++++++ .../references/expression-library.md | 184 ++++++++++++ .../after-effects/references/expressions.md | 134 +++++++++ .../references/performance-triage.md | 138 +++++++++ .../references/project-hygiene.md | 188 ++++++++++++ .../scripts/apply-effect-to-layers.jsx | 49 +++ .../after-effects/scripts/batch-rename.jsx | 41 +++ .../scripts/sequential-offset.jsx | 47 +++ .agents/skills/animation-principles/README.md | 0 .agents/skills/animation-principles/SKILL.md | 114 +++++++ .../references/easing-curves.md | 136 +++++++++ .../references/easing-graph-editor.md | 153 ++++++++++ .../references/twelve-principles.md | 82 +++++ .agents/skills/beat-sync-editing/README.md | 0 .agents/skills/beat-sync-editing/SKILL.md | 229 ++++++++++++++ .../references/editing-techniques.md | 137 +++++++++ .agents/skills/color-motion/README.md | 0 .agents/skills/color-motion/SKILL.md | 175 +++++++++++ .../references/color-management.md | 165 +++++++++++ .../references/palettes-and-interpolation.md | 180 +++++++++++ .agents/skills/logo-animation/README.md | 0 .agents/skills/logo-animation/SKILL.md | 148 ++++++++++ .../references/logo-patterns.md | 199 +++++++++++++ .agents/skills/motion-art-direction/README.md | 0 .agents/skills/motion-art-direction/SKILL.md | 114 +++++++ .../references/direction-playbook.md | 184 ++++++++++++ .agents/skills/motion-background/README.md | 0 .agents/skills/motion-background/SKILL.md | 279 ++++++++++++++++++ .../references/background-recipes.md | 233 +++++++++++++++ .agents/skills/remotion-video/README.md | 0 .agents/skills/remotion-video/SKILL.md | 194 ++++++++++++ .../references/api-and-patterns.md | 224 ++++++++++++++ .agents/skills/shot-composition/README.md | 0 .agents/skills/shot-composition/SKILL.md | 185 ++++++++++++ .../references/camera-and-grids.md | 153 ++++++++++ .claude/skills/after-effects | 1 + .claude/skills/animation-principles | 1 + .claude/skills/beat-sync-editing | 1 + .claude/skills/color-motion | 1 + .claude/skills/logo-animation | 1 + .claude/skills/motion-art-direction | 1 + .claude/skills/motion-background | 1 + .claude/skills/remotion-video | 1 + .claude/skills/shot-composition | 1 + skills-lock.json | 59 ++++ 47 files changed, 4385 insertions(+) create mode 100644 .agents/skills/after-effects/README.md create mode 100644 .agents/skills/after-effects/SKILL.md create mode 100644 .agents/skills/after-effects/references/export-recipes.md create mode 100644 .agents/skills/after-effects/references/expression-library.md create mode 100644 .agents/skills/after-effects/references/expressions.md create mode 100644 .agents/skills/after-effects/references/performance-triage.md create mode 100644 .agents/skills/after-effects/references/project-hygiene.md create mode 100644 .agents/skills/after-effects/scripts/apply-effect-to-layers.jsx create mode 100644 .agents/skills/after-effects/scripts/batch-rename.jsx create mode 100644 .agents/skills/after-effects/scripts/sequential-offset.jsx create mode 100644 .agents/skills/animation-principles/README.md create mode 100644 .agents/skills/animation-principles/SKILL.md create mode 100644 .agents/skills/animation-principles/references/easing-curves.md create mode 100644 .agents/skills/animation-principles/references/easing-graph-editor.md create mode 100644 .agents/skills/animation-principles/references/twelve-principles.md create mode 100644 .agents/skills/beat-sync-editing/README.md create mode 100644 .agents/skills/beat-sync-editing/SKILL.md create mode 100644 .agents/skills/beat-sync-editing/references/editing-techniques.md create mode 100644 .agents/skills/color-motion/README.md create mode 100644 .agents/skills/color-motion/SKILL.md create mode 100644 .agents/skills/color-motion/references/color-management.md create mode 100644 .agents/skills/color-motion/references/palettes-and-interpolation.md create mode 100644 .agents/skills/logo-animation/README.md create mode 100644 .agents/skills/logo-animation/SKILL.md create mode 100644 .agents/skills/logo-animation/references/logo-patterns.md create mode 100644 .agents/skills/motion-art-direction/README.md create mode 100644 .agents/skills/motion-art-direction/SKILL.md create mode 100644 .agents/skills/motion-art-direction/references/direction-playbook.md create mode 100644 .agents/skills/motion-background/README.md create mode 100644 .agents/skills/motion-background/SKILL.md create mode 100644 .agents/skills/motion-background/references/background-recipes.md create mode 100644 .agents/skills/remotion-video/README.md create mode 100644 .agents/skills/remotion-video/SKILL.md create mode 100644 .agents/skills/remotion-video/references/api-and-patterns.md create mode 100644 .agents/skills/shot-composition/README.md create mode 100644 .agents/skills/shot-composition/SKILL.md create mode 100644 .agents/skills/shot-composition/references/camera-and-grids.md create mode 120000 .claude/skills/after-effects create mode 120000 .claude/skills/animation-principles create mode 120000 .claude/skills/beat-sync-editing create mode 120000 .claude/skills/color-motion create mode 120000 .claude/skills/logo-animation create mode 120000 .claude/skills/motion-art-direction create mode 120000 .claude/skills/motion-background create mode 120000 .claude/skills/remotion-video create mode 120000 .claude/skills/shot-composition create mode 100644 skills-lock.json diff --git a/.agents/skills/after-effects/README.md b/.agents/skills/after-effects/README.md new file mode 100644 index 0000000..e69de29 diff --git a/.agents/skills/after-effects/SKILL.md b/.agents/skills/after-effects/SKILL.md new file mode 100644 index 0000000..c7f266b --- /dev/null +++ b/.agents/skills/after-effects/SKILL.md @@ -0,0 +1,84 @@ +--- +name: after-effects +description: This skill should be used when the user asks anything about Adobe After Effects — to "write an After Effects expression", "make a wiggle / loopOut / inertial bounce", "rig a control with a slider / null", "build a MOGRT / Essential Graphics template", "export AE to Lottie or Media Encoder"; OR to "export from After Effects", "export with transparency / an alpha channel", "fix a black background on export", "choose ProRes vs H.264", "which codec / what bitrate for 1080p / 4K", "stop H.264 disappearing from the Render Queue"; OR when "After Effects is slow / laggy / crashing / froze", "RAM preview won't play in real time", "AE is using all my memory / render takes forever", "how do I speed up After Effects"; OR to "organize my After Effects project", "relink missing footage", "fix broken links after moving files", "set a folder structure / naming conventions", "batch rename layers", or "write an ExtendScript / .jsx script". Covers expressions & rigging, export recipes, performance triage, and project hygiene. +version: 0.1.0 +--- + +# After Effects + +After Effects is GUI software, so this skill delivers knowledge and ready-to-paste assets — expressions, rig setups, export checklists, diagnostic flows, naming schemes, and ExtendScript — rather than a rendered file. It is a hub covering four domains; route to the matching reference for depth and complete recipes. + +## Routing + +| If the user wants to… | Go to | +|---|---| +| Write/debug an expression, rig sliders & nulls, build a MOGRT, export to Lottie | `references/expressions.md` (deep cookbook in `references/expression-library.md`) | +| Choose a codec/container, export with alpha, fix a black background, set bitrate, recover H.264 | `references/export-recipes.md` | +| Fix slow/laggy previews, slow renders, crashes, freezes, out-of-memory | `references/performance-triage.md` | +| Organize the project, relink missing footage, set naming/folders, batch-automate with .jsx | `references/project-hygiene.md` | + +The `.jsx` automation scripts live in `scripts/`. + +## Expressions & rigging + +Expressions are JavaScript evaluated on the property they are pasted on; `value` is that property's value, `time` is comp time in seconds, and `index`, `thisLayer`, `thisComp` are in scope. An expression overrides keyframes unless it incorporates `value`. + +```js +wiggle(2, 30); // 2 wiggles/sec, amplitude 30 (property units) +loopOut("cycle"); // repeat keyframed range forever; "pingpong" / "offset" / "continue" +seedRandom(index, true); // stable-but-unique per layer (timeless) before random()/wiggle() +thisComp.layer("Lead").transform.position.valueAtTime(time - 0.2 * index); // staggered echo +``` + +Inertial bounce (overshoot/settle after the last keyframe) and the full loop/wiggle/rigging set are in `references/expressions.md`. + +Rig controllable motion: add a null with **Slider / Checkbox / Color / Angle / Point** control effects, then reference them and parent transforms to drive many layers from one. + +```js +ctrl = thisComp.layer("Controls"); +amt = ctrl.effect("Intensity")("Slider"); // Checkbox → 1/0, Color → [r,g,b,a] +value * amt; +``` + +Expose those controls via **Window → Essential Graphics** and **Export Motion Graphics Template** (.mogrt) for Premiere/AE editors. + +## Export recipes + +Two engines, and choosing wrong is the root of most export confusion: +- **Render Queue (RQ)** — masters/intermediates: ProRes, image sequences, lossless, alpha. +- **Adobe Media Encoder (AME)** — delivery: H.264 MP4, H.265, social presets. + +Since AE CC 2014/2015 the native **H.264 output module was removed from the RQ** — make MP4s in AME, not the RQ. **H.264/MP4 cannot store alpha**, so a transparent comp exported to H.264 always fills with black; that is the classic "black background" complaint and not a bug. For transparency use **ProRes 4444**, a **PNG/TIFF sequence**, or **HEVC-alpha (Safari) + VP9/WebM-alpha (Chrome)**, with Output Module **Channels: RGB + Alpha**. + +Quick targets: editor handoff → **ProRes 422 HQ**; master/grade or alpha → **ProRes 4444**; web/social/client → **H.264 via AME**, VBR 2-pass (~10–16 Mbps 1080p, ~35–45 Mbps 4K). Full matrix, social specs, and step-by-step alpha exports in `references/export-recipes.md`. + +## Performance triage + +Work top-down by symptom, cheapest fix first, and stop when it clears. Most settings are in `Edit > Preferences` (Win) / `After Effects > Settings` (Mac). + +- **Slow previews:** Half/Third resolution → enable **Multi-Frame Rendering** → raise RAM allocation (leave ~6 GB for OS) → Adaptive fast previews → purge cache → Disk Cache on SSD/NVMe → solo heavy layers/effects → HW-accelerated decode → proxy heavy comps. +- **Slow renders:** confirm MFR on → RQ for masters / AME for delivery → HW decode H.264 → pre-render slow precomps → cheaper effects → transcode long-GOP to ProRes. +- **Crashes/freezes:** purge + empty disk cache → update **NVIDIA Studio** (not Game-Ready) drivers → reset prefs (`Ctrl/Cmd+Alt+Shift` on launch) → pull third-party plugins → free disk space → disable MFR if MFR-specific → roll back AE after a bad update. + +MFR needs several GB RAM per active core. Ordered flows, exact preference paths, and the proxy workflow are in `references/performance-triage.md`. + +## Project hygiene + +Keep projects organized, portable, and automatable. + +- **Folders:** numeric-prefixed bins (`01_Comps`, `02_Precomps`, `03_Footage`, …, `99_Old`) for stable sort order. +- **Naming:** `PROJECT_section_descriptor_v01`; precomps `PRE_`; rename solids/nulls to their role (`CTRL_master`); no spaces/special chars for farm/cross-OS safety. +- **Broken links:** AE references footage by path, so moving files breaks links. Double-click a missing item → **Replace Footage > File** and AE relinks the whole folder at once; enumerate with `File > Dependencies > Find Missing Footage`. **Always hand off projects via `File > Dependencies > Collect Files`**, never a bare `.aep`. +- **ExtendScript (.jsx):** wrap batches in `app.beginUndoGroup(...) / app.endUndoGroup()`; apply effects by **matchName** (e.g. `"ADBE Gaussian Blur 2"`), not the display name. Ready scripts: `scripts/batch-rename.jsx`, `scripts/sequential-offset.jsx`, `scripts/apply-effect-to-layers.jsx`. + +Full naming scheme, label-color system, relink/Collect-Files/Reduce workflows, and scripting setup in `references/project-hygiene.md`. + +## Reference files + +- `references/expressions.md` — expressions, rigging, MOGRT, Lottie/Media Encoder basics. +- `references/expression-library.md` — deeper expression cookbook: tuned inertial bounce, all loop variants, advanced wiggle, valueAtTime echoes, seedRandom grids, full rigging + coordinate spaces, MOGRT and Lottie/Bodymovin steps, Media Encoder presets. +- `references/export-recipes.md` — full codec/alpha/bitrate matrix, per-platform social specs, step-by-step transparency exports, AME preset cautions. +- `references/performance-triage.md` — ordered preview/render/crash flows, preference paths and values, MFR/GPU/disk-cache tuning, pre-render & proxy workflow. +- `references/project-hygiene.md` — folder template, naming and label systems, relink/Collect Files/Reduce details, scripting setup. +- `scripts/batch-rename.jsx`, `scripts/sequential-offset.jsx`, `scripts/apply-effect-to-layers.jsx` — ExtendScript automations. + diff --git a/.agents/skills/after-effects/references/export-recipes.md b/.agents/skills/after-effects/references/export-recipes.md new file mode 100644 index 0000000..a5acb31 --- /dev/null +++ b/.agents/skills/after-effects/references/export-recipes.md @@ -0,0 +1,168 @@ +# Export Recipes — Codec, Container, Alpha, Bitrate + +Pick the correct codec, container, alpha handling, and bitrate for a given delivery target, and avoid the classic failures: black backgrounds where transparency was expected, H.264 that vanished from the Render Queue, and bloated or muddy files. + +## The two export engines + +After Effects has two output paths. Choosing the wrong one is the root of most export confusion. + +- **Render Queue (RQ)** — `Composition > Add to Render Queue`. Best for mastering/intermediate formats: ProRes, image sequences, lossless, alpha. Renders inside AE. +- **Adobe Media Encoder (AME)** — `Composition > Add to Adobe Media Encoder Queue` (or the RQ "Queue in AME" button). Best for delivery/compressed formats: H.264 MP4, H.265, social presets. Renders in a separate app so AE stays usable. + +**Why H.264 disappeared from the Render Queue:** Since AE CC 2014/2015, Adobe removed the native H.264, H.264 Blu-ray, and MPEG-2 output modules from the RQ. To make an MP4, use AME — not the RQ. There is no setting to restore it in the RQ; that workflow is intentional. + +## Decision tree + +``` +Need transparency (alpha) in the final file? +├─ YES, for an editor/compositor (NLE) → ProRes 4444 (.mov), RGB+Alpha, RQ +│ └─ smaller, still alpha? → PNG sequence or TIFF sequence (RGB+Alpha) +├─ YES, for the web/browser → dual export: +│ • HEVC with alpha (.mov, Safari/iOS) +│ • VP9/WebM with alpha (Chrome/Firefox/Edge) +└─ NO alpha needed + ├─ Final delivery / upload (YouTube, social, client review) → H.264 MP4 via AME + ├─ Editorial / intermediate / grading → ProRes 422 HQ or 422 (.mov), RQ + ├─ Mastering / archival, highest fidelity → ProRes 4444 or lossless / image seq + └─ Tiny looping clip, limited colors → GIF (via AME / Photoshop), or WebM +``` + +## Transparency — the black background problem + +H.264/MP4 **cannot store an alpha channel**. Exporting a comp with transparent areas to H.264 always fills them with black (or white). This is the single most common export complaint and it is not a bug. + +To actually keep transparency: + +1. Use a format that supports alpha: **ProRes 4444**, **PNG/TIFF sequence**, **HEVC-with-alpha**, or **VP9/WebM-with-alpha**. +2. In the RQ Output Module, set **Channels: RGB + Alpha** and **Depth** to Millions of Colors+ (the "+" is the alpha). +3. Choose a matte type: **Premultiplied (Matted with color)** for most cases; **Straight (Unmatted)** if the compositor explicitly wants straight alpha. Straight alpha avoids dark/light fringing on edges when re-composited, but only some apps import it cleanly. + +For web transparent video, no single file plays everywhere. Ship two and use the HTML `