media-use

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

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/zamansepeti43/c-rak-agent --skill media-use-zamansepeti43
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: media-use
Source: https://github.com/zamansepeti43/c-rak-agent/tree/main/video-engine/.agents/skills/media-use
Command: npx skills add https://github.com/zamansepeti43/c-rak-agent --skill media-use-zamansepeti43

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 floods the agent context with candidates and leaves assets unmanaged. This Skill resolves any media need into a frozen local file plus a ledger record, keeping search noise on disk and handing the agent a single path. ## 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 and registers the result. - Four media types: Supports bgm, sfx, image, and icon via HeyGen audio catalog (10k+ tracks) and asset search (75k+ vectors), with ffprobe-extracted duration and dimensions. - Adopt existing projects: Bulk-imports files already in assets/ into .media/manifest.jsonl and generates an agent-readable index.md inventory. - Use Case: While building a video composition that needs upbeat background music, run resolve with type bgm and your intent; the Skill downloads the best catalog match, freezes it to .media/audio/bgm/, and returns one line with the local path. ## Quick Start Ask the agent to resolve background music for your composition by describing the mood, for example requesting an upbeat tech launch track for the current project.

Frequently Asked Questions about media-use

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

FAQPage Schema
How do I add background music to a video composition with an agent?

Run the resolve script with --type bgm and a natural-language --intent describing the track. The Skill searches the HeyGen audio catalog, downloads the best match, freezes it into .media/audio/bgm/, and returns one line with the local path.

How do I import existing assets into a media manifest?

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

What media types does the resolve command support?

The resolve command supports bgm, sfx, image, and icon types. Audio comes from the HeyGen audio catalog, while images and icons come from HeyGen asset search; a bundled 19-file SFX library is also available.

Does media-use work without the heygen CLI installed?

Cache and manifest lookups still work, but provider searches require the heygen CLI v0.1.6 or later with a valid HEYGEN_API_KEY. Without it, providers print a diagnostic and resolve reports that no provider could resolve the request.

How does cross-project asset reuse work?

Resolved assets are cached in a global content-addressed store at ~/.media/ keyed by SHA-256. A later resolve with the same prompt or entity hits this cache and imports the file into the new project without re-downloading.

Why does resolve fail to find a sound effect?

SFX search applies a minimum score of 0.4, so weak catalog matches are rejected. Check stderr for provider diagnostics, verify heygen authentication, and confirm the intent describes an available sound.