Agent skill · creative production · aiskillstore
media-use
Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Keeps search noise on disk, hands the agent one path or block. Use for any audio, image, icon, logo, voiceover, caption, color-grading, or media-asset need.
Why this skill is useful
Adds executable scripts for media resolution and generation that extend the AI's capabilities beyond standard media handling.
What it needs
Requires heygen installed locally. About 9k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
media-use The media OS for HyperFrames: resolve · generate · operate · remember, every media type, one skill, zero context noise. Setup — install heygen first (free-usage path) This unlocks the FREE path for bgm/sfx/image/icon catalog search, TTS (voice), and avatar videos. Sign in with --oauth — the free allowance rides on the OAuth session (an API key bills API credits instead). media-use requires heygen >= v0.3.0 uniformly (the OAuth free-usage path needs it), so --doctor nudges older CLIs to update even for API-key-only use. Before resolving anything, verify setup with: What it owns (the gaps HyperFrames leaves) HyperFrames owns media playback; media-use owns everything else. Each row is enforced by scripts/lib/coverage.test.mjs so the claim can't rot. HyperFrames gap media-use owns it via ------------------------------------------ ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Audio-only, no image/icon resolve --type image\ icon (heygen asset search) No third-party brand logos resolve --type logo (svgl → simple-icons → GitHub org avatar → domain favicon) No voice / audio generation resolve --type voice (HeyGen TTS free-usage path; optional local Kokoro) + the audio engine (audio/scripts/audio.mjs) Scattered/duplicated audio engine one consolidated engine under audio/ (hyperframes-media retired) No agent media-ops (cut/reframe/transform) references/operations.md + resolve --from to register outputs No transcript-driven cutting scripts/transcript-cut.mjs compiles word-timestamp edits into cut lists No auto-duck / publish loudness scripts/audio-duck.mjs + references/operations.md loudnorm/sidechain recipes No cross-project memory global content-addressed cache + auto-promote (~/.media) No color-grade authoring resolve --type grade emits a …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/media-use