meme-creator

1# Meme Creator
2 
3Turn a video clip into a meme: images (logos, avatars, stickers) glued onto
4moving objects so they follow the motion frame by frame, delivered as MP4 + GIF.
5 
6The failure mode that ruins this is not tracking drift — it is gluing the
7*wrong person's* avatar on screen because a name was bound to the first
8plausible account found. So step 0 is identity, not tooling.
9 
10For a static image meme, skip tracking entirely: put one `manual_keys` entry
11per target (`[[1, [x, y, w, h]]]`) in the overlays config and render just that
12frame — `--tracks` is optional when every position comes from keys.
13 
14## Requirements
15 
16- `ffmpeg` on PATH
17- `uv` — all bundled Python scripts carry inline dependencies; run them with
18  `uv run <script>` and deps resolve themselves
19- `yt-dlp` only when downloading (`uv run --with yt-dlp yt-dlp ...`)
20- Chrome/Chromium only when rasterizing an SVG logo (asset-binding.md)
21- Script paths below are written `scripts/…` **relative to this skill's bundle
22  directory**. Resolve the bundle path once (`SKILL_DIR=<path to this skill>`)
23  and run `"$SKILL_DIR"/scripts/make_sheets.py …` — your working directory is
24  the scratch dir, not the bundle.
25 
26## Pipeline
27 
28Work inside a scratch directory (`/tmp/<meme-name>/` or similar), deliver only
29the final MP4 + GIF.
30 
31### 0. Bind identities before fetching assets
32 
33When the user names who/what goes on screen ("Codex, Claude, and Tibo's
34avatar"), every ambiguous name must survive the disambiguation gate in
35…