A media-resolution workflow that finds and stores local files for background music, sound effects, images, and icons, while recording them in a manifest.

Use it when a composition needs music, sound effects, photos, backgrounds, icons, or logos. It can search the project cache, global cache, bundled sounds, or the HeyGen catalog.

It turns a broad media request into one fixed local file and keeps search results and metadata out of the agent’s working context.

How maiscafe/video_motion configures Claude Code and Codex

Reuse

Borrowing it

Nothing to install: this file belongs to maiscafe/video_motion. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/maiscafe/video_motion/master/.agents/skills/media-use/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/maiscafe/video_motion

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/maiscafe/video_motion/media-use/github.svg)](https://agentmods.dev/skills/maiscafe/video_motion/media-use)

Your own site

<a href="https://agentmods.dev/skills/maiscafe/video_motion/media-use"><img src="https://agentmods.dev/badge/skills/maiscafe/video_motion/media-use/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/maiscafe/video_motion/media-use"><img src="https://agentmods.dev/badge/skills/maiscafe/video_motion/media-use.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 84 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,456 The whole file, excluding the scripts and references it only reads on demand.

Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin 100% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00084	$0.01456
Opus 5.5	$0.00034	$0.00582
Sonnet 5.5	$0.00017	$0.00291
Haiku 4.5	$0.00008	$0.00146

Measured 2mo ago against content hash 139ac9d65345, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

media-use scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

The scan reads SKILL.md. This mod also ships 17 executable files (scripts/eval.mjs, scripts/lib/adopt.mjs, scripts/lib/bgm-provider.mjs, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -fsSL https://static.heygen.ai/cli/install.sh | bash # installs latest to ~/.local/bin

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -fsSL https://static.heygen.ai/cli/install.sh | bash # installs latest to ~/.local/bin

Origin

This is a copy

100% identical to media-use — 176 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/skills/media-use/SKILL.md · 125 lines

How it starts

The opening of the file, as written. The whole thing — 125 lines — stays where its author put it; the contents beside it link to each section on GitHub.

media-use

Resolve media needs into frozen local files. One verb, four types, zero context noise.

When to use

Call resolve whenever a composition needs media — background music, sound effects, images, or icons. media-use searches the HeyGen catalog, downloads the best match, freezes it locally, and registers it in a manifest. The agent gets back one line; all search noise stays on disk.

Resolve

node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>

Returns one line: resolved <id> → <path> (<type>, <metadata>)

Types

Type	What it finds	Provider
`bgm`	Background music	HeyGen audio catalog (10k+ tracks)
`sfx`	Sound effects	Bundled 19-file library + HeyGen catalog
`image`	Photos, backgrounds	HeyGen asset search (75k+ vectors)
`icon`	Icons, logos	HeyGen asset search (type=icon)

Examples

# Background music
node <SKILL_DIR>/scripts/resolve.mjs --type bgm --intent "upbeat tech launch" --project .
# → resolved bgm_001 → .media/audio/bgm/bgm_001.mp3 (bgm, 25s)

# Sound effect
node <SKILL_DIR>/scripts/resolve.mjs --type sfx --intent "whoosh" --project .
# → resolved sfx_001 → .media/audio/sfx/sfx_001.mp3 (sfx, 0.57s)

# Image
node <SKILL_DIR>/scripts/resolve.mjs --type image --intent "gradient tech background" --project .
# → resolved image_001 → .media/images/image_001.jpg (image)

# Icon
node <SKILL_DIR>/scripts/resolve.mjs --type icon --intent "rocket" --project .
# → resolved icon_001 → .media/images/icon_001.png (icon, transparent)

Flags

Flag	Description
`--type, -t`	Media type: bgm, sfx, image, icon
`--intent, -i`	What you need (natural language)
`--entity, -e`	Entity name for cache matching (optional)
`--project, -p`	Project directory (default: .)
`--adopt`	Bulk-import existing assets/ into manifest
`--json`	Output JSON instead of one-line result

Read the full file on GitHub · 125 lines

Files

What ships with it

18 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 125 lines · 84 tokens per session scan C 139ac9d65345

Subscribe to this mod's changes

media-use is a skill published in the GitHub repository maiscafe/video_motion (2 stars, last pushed 4mo ago), licensed MIT. It adds 84 tokens to every session and 1,456 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). It is 100% identical to media-use, differing in 176 lines, and is treated as a copy.

Creative and media

media-use next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
media-usemaiscafe/video_motion	Skill	2	4mo ago	MIT	C	84	Claude Code, Codex
imagegenopenai/codex	Skill	133k	yesterday	Apache-2.0	A	113	Codex
playwright-climicrosoft/playwright	Skill	99k	yesterday	Apache-2.0	A	19	Claude Code
local-ai-agentsmicrosoft/ai-agents-for-beginners	Skill	79k	4d ago	MIT	A	200	Claude Code, Codex
systematic-debuggingobra/superpowers	Skill	313k	3d ago	MIT	A	21	Claude Code
next-cache-components-adoptionvercel/next.js	Skill	143k	yesterday	MIT	A	95	Claude Code
next-partial-prefetching-adoptionvercel/next.js	Skill	143k	yesterday	MIT	A	103	Claude Code

video_motion: Skill for Claude Code