media-use

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

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/Sergiotsk/Interstellar --skill media-use-sergiotsk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: media-use
Source: https://github.com/Sergiotsk/Interstellar/tree/main/.agents/skills/media-use
Command: npx skills add https://github.com/Sergiotsk/Interstellar --skill media-use-sergiotsk

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Finding, generating, and managing background music, sound effects, images, icons, logos, voices, and color grades for video compositions normally requires juggling many separate tools and catalogs. This Skill unifies every media need into one resolve verb that returns a frozen local file plus a ledger record, keeping search noise out of context. ## Core Features & Use Cases - One-verb media resolution: Resolve BGM, SFX, images, icons, brand logos, TTS voices, color grades, and LUTs into frozen local files with a single command, with reuse of assets across projects. - Audio engine: Produce voiceovers, transcriptions, captions, background removal, and GSAP volume-ducking keyframes through a shared audio pipeline. - Media operations and treatments: Cut, reframe, dither, and apply source-aware color treatments (VHS, camcorder, halftone, ASCII, and more) with deterministic persistence and verification. - Use Case: While building a HyperFrames video, you notice a 15-second piece has no music bed and an emoji styled as an icon. Run one media opportunity pass, resolve a real icon and a BGM track, and record both in the project ledger. ## Quick Start Ask the agent to resolve a warm cinematic background music track and a matching color grade for the current HyperFrames project.

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 intent, for example --type bgm --intent "warm cinematic bed" --project <dir>. It returns one line with the frozen local file path and records the asset in the project 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 lines; it writes audio_meta.json with word timestamps for captions. HeyGen CLI auth unlocks the free TTS path, with local Kokoro as an alternative.

Can I apply VHS, camcorder, or ASCII effects to existing footage?▼

Yes, media treatments compose validated shader payloads applied via the hyperframes media-treatment CLI to a real img or video element. Tested recipes cover VHS, camcorder, 8mm, halftone, ASCII, dither, and more, with bounded tuning ranges.

Does the dither script support HDR or LOG video input?▼

No, the 8-bit SDR dither processor rejects PQ and HLG tagged inputs with an explicit error. Tone-map HDR sources to Rec.709 first before running error-diffusion processing.

Why should I never read a .cube LUT file directly?▼

A 3D LUT contains roughly 36k lines of raw numbers that bloat context without legible signal. Use hyperframes grade-compare to see it rendered or cube-validate.mjs for a one-line validity check instead.

Can resolved media assets be reused across multiple projects?▼

Yes, list reusable candidates with resolve --candidates before resolving fresh, and ingest external files with --from. The ledger and cache let adopted assets be re-resolved as cache hits in later work.