Plugin installs: Before setup or freshness commands, follow plugin execution rules when this skill is inside a HyperFrames plugin.

Media in HyperFrames

Media lands as a local file in the project's assets/ with a ledger record; renders never fetch. One verb finds or makes it:

npx hyperframes media-use resolve --type <type> --intent "<what you need>" --project <dir>

It prints one line, resolved <id> → <path> (<type>, <metadata>). List reusable assets first with --candidates and judge the fit yourself; reuse, ingest (--from) and adopt are in references/resolve.md.

Two ways to get it

Host apps. Inside an app that gives you its own media tools, use those first. When HEYGEN_API_BASE is set, the host pays for HeyGen: don't ask for the heygen CLI or a sign-in, and when a call is refused, relay the host's message as written and stop.

HeyGen. Install the `heygen` CLI and sign in with heygen auth login --oauth: the OAuth session carries a free allowance on subscription credits; an API key (--api-key) bills API credits. Check setup with npx hyperframes media-use resolve --doctor. When a request needs HeyGen (a presenter or avatar, a HeyGen voice, catalog music) and heygen is missing or signed out, tell the person how to get it: the install link, heygen auth login --oauth for the free allowance, or an API key for credits. Then offer the free path or wait. Beyond resolve, the same CLI makes text-to-video (heygen video-agent create), avatar videos with a recorded track (heygen video create), cloned voices (heygen voice clone create), dubbing (heygen lipsync), translated videos (heygen video-translate) and short clips from a long video (heygen ai-clipping): recipes in references/operations.md.

Free. Every tool in the free column needs no account; local models are opt-in installs (references/setup-providers.md). Without heygen, resolve for music, images and icons fails and says so; credit CC BY sounds (audio/references/sfx.md). --local-only skips every network provider.

Cost. Confirm before a paid call you chose to make (an avatar video counts); one the person asked for just runs. --provider <name> pins one generator when the person names it.

Looks on real footage

Feedback that footage is dark, flat or dull, should feel retro or printed, needs a face hidden, or needs a reveal is media intent: read references/media-treatments.md. Inspect the real <img>/<video>, pick one intent, start from npx hyperframes media-treatment --capabilities --json, then --capability <id>; never --all. Persist the final treatment with npx hyperframes media-treatment; no CSS or SVG stand-ins for supported effects, and no generated .cube just to encode exposure or warmth.

Offer once, never add silently

When you build or review a piece, scan once for concrete gaps (on-screen text with no voiceover, emoji standing in for icons, placeholder images, silent cuts, 10 s+ with no music, a colour cast) and offer the specific fixes in one ask. No signal, no suggestion; respect "leave it".

Where to look