media-use

Resolves media needs into frozen local files with manifest registration and caching.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/X-manist/Cohmira --skill media-use-x-manist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: media-use
Source: https://github.com/X-manist/Cohmira/tree/main/src/builtin-plugins/openmontage/.agents/skills/media-use
Command: npx skills add https://github.com/X-manist/Cohmira --skill media-use-x-manist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Compositions often need background music, sound effects, images, or icons, but searching catalogs, downloading files, and tracking what was used floods the agent context with noise and leaves assets unmanaged. This Skill resolves any media need into a frozen local file plus a ledger record, returning a single line to the agent while keeping search candidates, scores, and provenance on disk. ## Core Features & Use Cases - One-verb resolution: A single resolve command cascades through project manifest, existing assets, global cache, and HeyGen catalog search, then freezes the file locally and registers it in .media/manifest.jsonl. - Four media types: Handles bgm, sfx, image, and icon via HeyGen audio catalog (10k+ tracks) and asset search (75k+ vectors), with a bundled 19-file SFX library. - Adopt existing projects: Bulk-imports files already in assets/ into the manifest, using ffprobe to extract real duration and dimensions. - Cross-project reuse: Content-addressed global cache at ~/.media/ (SHA-256) lets resolved assets be reused without re-downloading. - Use Case: While building a video composition, run resolve with intent "upbeat tech launch" and receive resolved bgm_001 → .media/audio/bgm/bgm_001.mp3 (bgm, 25s) — ready to reference in the composition. ## Quick Start Ask the agent to resolve a background music track for your project by describing the mood, for example: resolve an upbeat tech launch BGM into my current project directory.

Frequently Asked Questions about media-use

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve background music or sound effects for a video project?

Run the resolve script with a type and natural-language intent, for example --type bgm --intent "upbeat tech launch" --project . It searches the HeyGen audio catalog, freezes the best match into .media/, and returns one line with the asset id and path.

How do I import existing assets into the media manifest?

Run resolve with the --adopt flag against your project directory. It scans the assets/ folder, infers types from extensions and paths, probes duration and dimensions with ffprobe, and registers each unregistered file in .media/manifest.jsonl.

What dependencies does media-use require to run?

It requires Node.js to run the scripts, ffprobe for probing duration and dimensions during adopt, and the heygen CLI version 0.1.6 or later with a HEYGEN_API_KEY for catalog search. Without heygen, providers fail with a one-line diagnostic and resolve reports no provider could resolve.

Does media-use cache assets across projects?

Yes. Resolved assets are stored in a content-addressed global cache at ~/.media/ keyed by SHA-256. Subsequent resolves with the same prompt or entity hit the cache and copy the file into the project without re-downloading or calling the provider.

Why does resolve fail with no provider could resolve?

This happens when the heygen CLI is missing from PATH, the API key is invalid or expired, or the catalog search returns no results. Check stderr for the provider diagnostic, verify heygen is at least v0.1.6, and confirm HEYGEN_API_KEY is set.