media-use
An agent skill by heygen-com, from heygen-com/hyperframes. Tags: api, automation, generative, media.
What it does
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. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add heygen-com/hyperframes --skill media-use
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/heygen-com/hyperframes
cp -r hyperframes/skills/media-use ~/.claude/skills/media-use
Safety box score
Grade D, elevated risk: 46 of 100 risk points, rated 2026-10-21. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
media-use is a media pipeline skill that resolves, generates, and transforms audio/image assets while writing results into the project and the user's home media caches. Its main risks are outbound uploads to HeyGen/Google/Openverse, secret-bearing auth via env vars and credential files, and remote account changes such as HeyGen voice cloning/deletion; some core engine files were not readable in this review.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 2 (moderate) | It regularly spawns other programs (`spawnSync(...)`, `execFileSync(...)`) and can invoke a registry package via `npx --yes hyperframes@${pluginVersion}` in `scripts/resolve.mjs`. |
| Network access | 2 (moderate) | Inherent to the skill's purpose, it sends local media or prompts to third parties: HeyGen voice clone/TTS calls, Google Gemini TTS (`https://generativelanguage.googleapis.com/...`), and Openverse fetches. |
| Filesystem reach | 2 (moderate) | It writes project artifacts and user-home state under `.media`, `~/.media`, `~/.cache/hyperframes`, and `~/.hyperframes/config.json` (`return join(mediaHome(), ".media");`). |
| Secrets & credentials | 2 (moderate) | It reads API keys and credential files (`GEMINI_API_KEY`, `GOOGLE_API_KEY`, `GOOGLE_APPLICATION_CREDENTIALS`, `GCS_CREDS`, `~/.heygen/credentials`) and turns them into auth headers/tokens. |
| Privilege & persistence | 0 (none) | No sudo, services, shell startup edits, global installs, or other OS-level privilege changes were visible in the reviewed files. |
| Instruction hijack surface | 0 (none) | I did not find hidden instructions, prompt-skip rules, or fetched instruction chains in the visible files. |
| Irreversible actions | 2 (moderate) | It can make remote state changes such as cloning and deleting HeyGen voices, and it automatically records generated media into manifests and user-memory files. |
| Transparency | 2 (moderate) | Key engine files were not readable in this review (`audio/scripts/audio.mjs`, `audio/scripts/lib/tts.mjs`, `audio/scripts/lib/sfx.mjs`, `scripts/lib/manifest.mjs`), so some behavior is still unverified. |
Before installing
- Read `audio/scripts/heygen-voice.mjs`: it can upload local audio and delete HeyGen voices.
- If you want to avoid home-directory writes, set `HYPERFRAMES_MEDIA_HOME` to a temp dir before trying it.
- Verify which credentials are present and acceptable to expose: `HEYGEN_API_KEY`, `HYPERFRAMES_API_KEY`, `GEMINI_API_KEY`, `GOOGLE_API_KEY`, `GOOGLE_APPLICATION_CREDENTIALS`.
- Review the unread core files (`audio/scripts/audio.mjs`, `audio/scripts/lib/tts.mjs`, `audio/scripts/lib/sfx.mjs`, `scripts/lib/manifest.mjs`) before letting an agent run the skill.
Rated 2026-10-21 by an automated review of 61 files from the skill's repository.
Source
- Repository
- heygen-com/hyperframes (all skills from this repository)
- Path
- skills/media-use/SKILL.md
- Branch
- main
- Updated
- 2026-09-19
Related skills
- agents-connect — Use when connecting your agent to external APIs, tools, or services via Gateway, or restricting tool access with Cedar policies.
- amazon-bedrock — Builds generative AI applications on Amazon Bedrock.
- cursor-sdk — Guide users building apps, scripts, CI pipelines, or automations on top of the Cursor TypeScript SDK (`@cursor/sdk`).
- free-tools — When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness.
- gh-cli — Enforces authenticated gh CLI workflows over unauthenticated curl, WebFetch, and MCP fetch patterns.
- running-release-tests — Run automated release testing (UI or API) via the AWS DevOps Agent using a pre-configured test profile.