media-use

Resolve, generate, and operate on media assets for HyperFrames compositions.

1|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill media-use-marshal-nguyen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: media-use
Source: https://github.com/Marshal-Nguyen/Skill_Claude_Agent/tree/main/claude/skills/media-use
Command: npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill media-use-marshal-nguyen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building video compositions requires sourcing background music, sound effects, images, icons, logos, voiceovers, and color grades from scattered catalogs and tools. This Skill unifies every media need into one resolve verb that returns frozen local files plus a ledger record, eliminating manual asset hunting and inconsistent media handling across projects. ## Core Features & Use Cases - Unified Media Resolution: Resolve BGM, SFX, images, icons, brand logos, TTS voices, color grades, and LUTs through one command, with catalog search, generation fallback, and cross-project asset reuse via a local media ledger. - Audio Engine: Produce voiceovers with word-level timestamps, background music, captions, transcription (Parakeet with whisper.cpp fallback), and background removal through a shared audio pipeline. - Media Operations & Treatments: Cut, reframe, dither (exact error diffusion via FFmpeg), and apply source-aware color treatments such as VHS, camcorder, halftone, ASCII, and film looks through validated shader payloads. - Use Case: While building a HyperFrames promo video, resolve a synthwave music bed, generate a TTS voiceover with captions, fetch an official brand logo, and apply a corrective color grade to underexposed footage, all recorded in the project's media ledger for reuse. ## Quick Start Ask the agent to resolve a background music track for your project by describing the mood, for example requesting an upbeat electronic track for the current composition.

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 for a video project?▼

Run the resolve script with type bgm and a one-line intent describing the mood, such as an upbeat electronic track. The skill searches the HeyGen catalog of over 10,000 tracks, freezes the chosen file locally, and records it in the project media ledger.

How do I add a TTS voiceover with captions to a composition?▼

Use the shared audio engine with an audio_request.json listing your script lines. It produces voice files with word-level timestamps in audio_meta.json, which you can use directly for captions and GSAP volume ducking keyframes.

Can I apply a VHS or retro film look to existing footage?▼

Yes, the media treatments reference provides tested recipes for VHS playback, 8mm home movie, camcorder, and film memory looks. Each recipe is a validated shader payload applied through the hyperframes media-treatment command with bounded tuning ranges.

Does the dither script support HDR video input?▼

No, the dither processor is 8-bit SDR only and rejects PQ or HLG tagged inputs with an explicit error. You must tone-map HDR footage to Rec.709 before running error diffusion.

What setup is required before resolving media assets?▼

Install and sign in to the heygen CLI, which unlocks the free-usage path for TTS and catalog retrieval. Then verify the environment with the resolve script's doctor flag, which checks providers and local tools like FFmpeg.

When should I use a LUT versus a realtime color grade?▼

Use preset or adjustment JSON for ordinary correction and polish since the realtime shader already owns those controls. Reserve .cube LUTs for reusable transforms the user supplies or when a treatment explicitly owns one; never generate a LUT just to encode exposure or contrast.