Diogenesoftoronto/keating / video/keating-surface-tour/.agents/skills/motion-graphics
motion-graphics
VerifiedA short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.3 KB |
| agents/builder.md | markdown | 3.3 KB |
| agents/director.md | markdown | 5.6 KB |
| agents/finalize.md | markdown | 1.0 KB |
| catalog-map.md | markdown | 10.3 KB |
| categories/asset-fusion/module.md | markdown | 3.9 KB |
| categories/charts/module.md | markdown | 1.6 KB |
| categories/kinetic-type/module.md | markdown | 1.6 KB |
| categories/logo-reveal/module.md | markdown | 1.1 KB |
| categories/lower-thirds/module.md | markdown | 1.1 KB |
| categories/maps/bake-basemap.mjs | script | 14.4 KB |
| categories/maps/module.md | markdown | 9.4 KB |
| categories/news/module.md | markdown | 5.3 KB |
| categories/stat/module.md | markdown | 1.2 KB |
| categories/tweet/module.md | markdown | 1015 B |
| categories/webpage/module.md | markdown | 2.5 KB |
| grounding/PROTOCOL.md | markdown | 3.0 KB |
| grounding/locate.mjs | script | 8.0 KB |
| phases/source/guide.md | markdown | 1.9 KB |
| references/builder-contract.md | markdown | 2.8 KB |
| references/motion-vocabulary.md | markdown | 3.5 KB |
| references/shot-plan-ir.md | markdown | 2.6 KB |
| samples/asset-fusion/_ref-circle-highlight.html | other | 10.4 KB |
grounding/PROTOCOL.md
View on GitHub# locate — find "X" in an image (no detector API assumed)
The single contract every consumer (asset-fusion ring, webpage highlight, future
explainer/recut overlays) uses:
```
locate(image, target-description) → { box: [x0,y0,x1,y1], center: [cx,cy] } # normalized 0..1
```
## Why this exists
Author models are unreliable at **regressing pixel coordinates** on a cluttered
full image (measured: weak vision models ~16–24% center error → rings land off-target)
but reliable at **picking a numbered strip** (~3–4% with the loop below). So:
never eyeball coordinates; localize by discrete choice. (RSVP, ACL 2025.)
## Routing — pick the cheapest path that's actually available
1. **A strong detector is available** (e.g. `GEMINI_API_KEY` in env) →
`node grounding/locate.mjs auto <img> "<target>"` — one call, done.
**Never assume the key exists.** No key → path 2.
2. **No detector (the normal case)** → YOU are the localizer; run the grid loop.
## The grid loop (you read images between steps)
```
node grounding/locate.mjs overlay <img> --out /tmp/g
→ READ /tmp/g/gv.png (vertical strips 1-9) and gh.png (horizontal 1-9);
decide which strip numbers the target spans (list EVERY strip it touches).
node grounding/locate.mjs region <img> --vids 4,5 --hids 6,7 --out /tmp/g
→ READ /tmp/g/gc.png (the region cropped + upscaled, finer 6×6 grid);
pick the finer strips. (Pick strips again — do NOT switch to estimating
coordinates; discrete choice is the whole point, at BOTH stages.)
node grounding/locate.mjs final <img> --region <from step 2> --vids 3,4 --hids 3,4
→ the final {box, center}.
node grounding/locate.mjs mark <img> --box <final box> --out /tmp/g/check.png
→ VERIFY: READ check.png. Red box ON the target → done. Off → redo
region/final with corrected strips (you now know which direction). Never
skip this step; it converts silent misses into one cheap retry.
```
## Ambiguity — resolve BEFORE localizing
If the target description can match several instances ("a drum" when the scene
has five), no geometry will save you. First make the reference unique
("the right-most drum", "the drum on the front boat"), asking the user if
needed — then run the loop.
## Degradation path (if locate.mjs itself is unavailable)
The idea is 5 lines — reproduce it with any image tool:
draw a numbered 9×9 grid → pick the strips the target spans → crop that region
(+pad ~0.4 strip) and upscale → draw a finer 6×6 grid → pick again → map back
(`global = region_origin + local × region_size`) → draw the box and LOOK at it.
## Notes
- Geometry is frozen in `locate.mjs` (node + ffmpeg, zero npm deps — both
already required by hyperframes). Don't re-implement it ad hoc; the measured
accuracy holds for THIS implementation.
- Consumers: `samples/asset-fusion/_ref-circle-highlight.html` takes `CFG.box`
directly from `final`/`auto` output.
- Measured end-to-end (same agent, same template, only the localization step
differs): eyeballing 6.5% avg center error → this protocol 2.3%, no case worse.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |