hyperframes-audio

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

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/AbuBakar125-co/Resturant_web --skill hyperframes-audio-abubakar125-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-audio
Source: https://github.com/AbuBakar125-co/Resturant_web/tree/main/agent/skills/hyperframes-audio
Command: npx skills add https://github.com/AbuBakar125-co/Resturant_web --skill hyperframes-audio-abubakar125-co

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, levels drift between passages. This Skill mixes audio already placed in a HyperFrames composition by writing effect chains, automation envelopes, and voiceover carve settings directly onto the HTML media elements, so preview and render produce identical sound. ## Core Features & Use Cases - Voiceover Carve: Analyzes the voice track, finds the bands it occupies, and cuts only those bands in the music bed plus a level match, so the bed keeps its body while the voice stays intelligible. Run headless via node scripts/carve.mjs --comp index.html. - Effect Chains: Fourteen shipped effects (filters, compressor, limiter, gate, saturate, delay, reverb, chorus, phaser, bitcrush) written as JSON in data-fx-chain, with presets and named jobs like Tame Boominess, Reduce Mud, and Add Clarity for common symptoms. - Automation & Submix Buses: Breakpoint envelopes on volume or effect parameters via data-automation, and <hf-audio-group> buses that give several tracks one chain, one fader, and one composition-time automation clock. - Use Case: Given a composition where narration fights a music bed, run the carve script to detect the tracks, write peaking-filter dips and a ducking envelope onto the bed, and re-run safely at a new strength without touching hand-built effects. ## Quick Start Run the carve script with node scripts/carve.mjs --comp index.html to automatically detect the voice and music bed and write a dynamic voiceover carve into the composition.

Frequently Asked Questions about hyperframes-audio

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

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

Run node scripts/carve.mjs --comp index.html, which detects the voice and bed tracks, analyzes the voice's bands, and writes peaking-filter dips plus a level-match envelope onto the bed. Use --bed and --voice to name tracks explicitly and --strength to adjust depth.

How do I add audio effects like EQ or reverb to a HyperFrames track?

Write a JSON effect chain into the track's data-fx-chain attribute, listing nodes in signal order with types like highpass, peaking, compressor, or reverb. Check references/presets.md first, since named jobs like Reduce Mud or Add Clarity usually already match the symptom.

What are the requirements for running the carve script?

The carve script needs ffmpeg on PATH to decode audio and @hyperframes/core installed in the composition's project via npm i -D @hyperframes/core. It resolves core from the project directory, not from the skill's own location.

Why is my automation lane on a compressor not moving?

Compressor, limiter, gate, and bitcrush are worklet-based effects with no automatable AudioParams, so lanes on their parameters are silently inert. Automate a gain stage before the compressor instead to change how hard it is driven over time.

When should I use an hf-audio-group bus instead of per-clip effects?

Use a bus when the same treatment belongs on several tracks, such as one compressor over four narration clips, giving them one chain, one fader, and one composition-time automation clock. Keep per-clip chains for genuinely per-clip fixes like one noisy take.

What audio problems can this skill not fix?

Nothing shipped does proper de-essing, noise removal under speech, or automatic tone matching between tracks. A narrow peaking cut in the 5-9 kHz edge band is the stated fallback for sibilance, while hiss beneath speech requires a better source recording.