SKILL.md
motion-graphics — dispatch entry
Confirm the route before Step 0. This skill makes a short, design-led, unnarrated motion graphic (motion is the message; ~under 10s, no voice-over). A longer, multi-scene, or narrated treatment →
/general-video; a narrated video of a website →/website-to-video; a topic explainer →/faceless-explainer; a product promo →/product-launch-video; captions on existing footage →/embedded-captions. Out of scope: live / at-render-time data, or footage it can't capture. Unsure motion-first-vs-narrated? Read/hyperframesfirst.
A short design-led motion graphic. Asset-first: decide the asset strategy and source real material before designing the shot, then design the shot around what you have, then compose by reusing catalog capabilities. All artifacts go to PROJECT_DIR = videos/<project-name>/ (created in Step 0); all paths below are relative to it.
| Phase | Execution | Primary artifact | Detailed flow |
|---|---|---|---|
| init | Bash | hyperframes.json |
Step 0 |
| plan | subagent — decide search? + classify + asset strategy | shot-plan.json (draft: category, asset_needs queries, brief) |
agents/director.md (Part 1) |
| source ◇ | Bash — media-use resolve (skip if asset_needs is empty) |
assets/ + assets/index.md |
phases/source/guide.md |
| design | subagent — shot design around resolved assets | shot-plan.json (final: block(s) + layout + motion + positions) |
agents/director.md (Part 2) |
| build | subagent — reuse-first composition | compositions/index.html |
agents/builder.md |
| render | Bash — hyperframes render (MP4, or --format webm/mov for overlay) |
renders/video.mp4 |
Step 5 |
| verify | Bash — lint / inspect -> repair subagent on failure |
(fixes in place) | agents/finalize.md |
◇ source runs only when the chosen category declares assets. Pure code/text categories (e.g. kinetic-type, most charts/stat) have asset_needs: [] and skip straight from plan to design.