animation-direction

Files (1)

• SKILL.md

SKILL.md (first lines)

# Animation Direction

Motion-graphics direction without a video editor: "explain X" -> synced
b-roll/infographic animation. Corrections happen at the cheap plan
stage, never post-render.

## Pipeline

1. **Enrich** — `extensions/asr/transcribe.py url|file` (yt-dlp +
   whisper.cpp, offline) -> `{text, segments[{start,end,text}]}`;
   bootstrap via `extensions/asr/bootstrap.py` (explicit fetch only).
2. **Analyze** — keyframes (ffmpeg scene-select) + semantic beats: what
   concept each segment explains.
3. **Plan** — scene-plan v2 per beat:
   `{id, sync_range:[s,e], visual:{type,props},
     motion_spec:{easing,enter,exit,enter_s,exit_s}, overlay?}`.
4. **GATE (hard)** — render nothing until the plan is approved:
   `plan_check.py` output + `ask_user_question`/ledger sign-off.
5. **Render** — `extensions/remotion-render/render.py plan.json
   --workdir out/` -> Remotion project -> `npx remotion render`.
6. **Composite** — overlay on source via ffmpeg
   (`extensions/craft-bridge` filmcraft commands or media-tools path).

## Motion vocabulary

- Easings: `linear` (data/tickers), `spring` (emphasis, diagrams),
  `easeOut` (default entrances).
- Entrances: `fade` (default), `slideUp` (titles/steps), `scale`
  (callouts), `none` (cuts). Exits default `fade`, `none` on cut.
- Timing budgets: entrance <= 0.5s and <= half the beat; holds >= 1.5s
  for text; transitions only between narration cuts.

## Beat -> visual mapping

| Beat | visual.type | Notes |
|---|---|---|
| Claim / definition | `kinetic_text` | <= ~12 words on screen |
| Process / sequence | `diagram_nodes` | stagger 6f per node |
| Number / metric | `counter` | count up over ~1s + label |
| Screenshot / asset | `pan_zoom` | slow zoom 1.0->~1.15 |

Sync rules: beat duration >= read time (160 WPM); one visual on screen
unless `overlay: true`; no motion during narration cuts.

## Renderer selection

Default **Remotion** (this extension). Blender via `operate-blender`
when the visual is 3D. After-Effects JSX only if the user already has
AE. No paid TTS/ASR services; plan approval is a hard gate, always.

## Files

- `extensions/asr/` — transcribe + bootstrap.
- `extensions/remotion-render/` — `plan_check.py` (pre-gate validator:
  sync_range vs audio, overlap collisions, read-time + budget warnings),
  `render.py` (materialize template + render), `templates/remotion-project/`
  (Root + PlanComposition + primitives).
- Plan contract extends `craft-bridge` scene_manifest v1 with
  `motion_spec` + `sync_range` (v2).

From Leostruka/devin-bundle, MIT.

More from Leostruka/devin-bundle