hyperframes-audio

Mixes audio tracks in HyperFrames compositions with effects chains, automation, and voiceover carving.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @hyperframes/core, ffmpeg, and includes scripts (resource) and references (resource) components.

What problem does it solve? Audio tracks that sound fine alone often fight each other in a mix — a music bed drowns out a voiceover, a voice sounds boomy or harsh, and fixing it by ear is impossible for an agent that cannot listen. This Skill provides deterministic mixing for HyperFrames compositions: effect chains, volume automation, ducking, and a voiceover carve that cuts only the bands the voice occupies. ## Core Features & Use Cases - Voiceover carve: Analyzes voice tracks and writes peaking-filter dips plus a level-match envelope onto the music bed via data-fx-carve, data-fx-chain, and data-automation, so the voice stays intelligible without flattening the music. - Effect chains and automation: Ships gain, EQ, compressor, limiter, gate, saturate, delay, reverb, chorus, phaser, and bitcrush effects with per-parameter automation lanes, plus an <hf-audio-group> submix bus for treating several tracks at once. - Diagnosis without listening: Provides ffmpeg-based measurement recipes (band energy, noise floor, loudness via ebur128) to identify defects by comparing a file against itself rather than guessing. - Use Case: You have a narrated video composition where the background music fights the narration. Run node scripts/carve.mjs --comp index.html to automatically detect the bed and voices, carve the bed at strength 0.8, and write the mix attributes into the HTML. ## Quick Start Ask the AI to carve the music bed under the narration in your HyperFrames composition by running the carve script against your index.html file.

Frequently Asked Questions about hyperframes-audio

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

FAQPage Schema
How do I duck background music under a voiceover in HyperFrames?▼

Run the carve script with node scripts/carve.mjs --comp index.html. It detects the music bed and voice tracks by name, analyzes the speech bands, and writes peaking-filter dips plus a level envelope onto the bed so the voice stays clear without flattening the music.

What audio effects are available in a HyperFrames mix?▼

The shipped effect families are gain, EQ (highpass, lowpass, peaking, shelves), compressor, limiter, gate, saturate, delay, reverb, chorus, phaser, and bitcrush. Effects are written as JSON in the data-fx-chain attribute in signal order.

Can I automate a compressor or limiter parameter over time?▼

No. Compressor, limiter, gate, and bitcrush are AudioWorklet effects with no automatable AudioParams, so lanes on their parameters are silently inert. Automate a gain stage before the effect instead to change how hard it is driven.

Why did my carve stop working after adding a new narration clip?▼

A carve whose sources list names individual clip ids only covers those clips; a clip added later plays outside the carve. Group the voice clips with data-audio-group and carve against the group id so membership resolves at analysis time.

What dependencies does the carve script need?▼

The script requires ffmpeg on PATH to decode audio and @hyperframes/core installed in the composition's project via npm i -D @hyperframes/core. It loads the same analysis functions Studio uses, so CLI and Studio carves produce identical output.

When should I not use the voiceover carve?▼

Skip the carve when there is no voice for the music to sit under, such as a music video, title card, or montage cut to the track. Also never place a carve on a voice track itself; the settings belong on the bed being processed.