audio-mixing-mastering
Provider-independent audio mixing and mastering direction for AI agents finishing generated videos, ads, trailers, explainers, podcasts, recuts, avatar clips, music videos, documentaries, and social content. Use when planning, mixing, repairing, mastering, QCing, or delivering dialogue, music, ambience, and sound effects, including loudness/true-peak targets, intelligibility, accessibility, stems, stereo/immersive decisions, platform/client specs, and final audio QA.
calesthio · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add calesthio/generative-media-skills --skill audio-mixing-masteringAbout this skill
name: audio-mixing-mastering description: Provider-independent audio mixing and mastering direction for AI agents finishing generated videos, ads, trailers, explainers, podcasts, recuts, avatar clips, music videos, documentaries, and social content. Use when planning, mixing, repairing, mastering, QCing, or delivering dialogue, music, ambience, and sound effects, including loudness/true-peak targets, intelligibility, accessibility, stems, stereo/immersive decisions, platform/client specs, and final audio QA.
Audio Mixing and Mastering Direction
Use this skill when audio must survive real playback: phone speakers, earbuds, laptops, TV soundbars, cinema-style trailers, podcasts, client review links, broadcast deliveries, and social feeds. Treat the mix as a production decision, not as a last-minute normalization step.
The job is to make the audience understand the foreground, feel the intended energy, avoid fatigue or distortion, and pass the declared delivery spec.
Start with the audio contract
Before touching levels, write a short audio contract for the project:
- Delivery context: social post, YouTube upload, podcast RSS, streaming ad, broadcast, OTT, internal review, theatrical-style trailer, music video, documentary, localization, accessibility version.
- Foreground hierarchy: dialogue/VO first, performance/music first, sound-design impact first, or a changing hierarchy by scene.
- Required deliverables: full mix, dialogue stem, music stem, effects stem, M&E, narration-only, clean captions, audio-described version, alternate language mix, stereo fold-down, 5.1/Atmos printmaster, client preview.
- Target spec: use the client/platform/broadcaster spec if supplied. If no spec is supplied, choose a conservative target and label it as a heuristic.
- Monitoring assumption: headphones-only, nearfield speakers, phone/laptop check, calibrated room, or unavailable.
- Source risk: AI voice artifacts, room noise, inconsistent clips, clipping, music licensing, generated SFX harshness, missing room tone, mono/stereo mismatch, translated VO timing, or stem bleed.
Do not master blindly to the loudest reference. Streaming and broadcast systems may normalize loudness, and over-limiting can reduce clarity while gaining little or nothing at playback.
Evidence categories
Documented facts:
- ITU-R BS.1770-5 specifies algorithms for programme loudness and true-peak signal level measurement, including K-weighting, channel weighting, gating, and true-peak guidance. Verified 2026-07-10: https://www.itu.int/dms_pubrec/itu-r/rec/bs/R-REC-BS.1770-5-202311-I!!PDF-E.pdf
- EBU R 128 version 5.0 recommends normalising programme loudness to -23.0 LUFS; where attaining target level is not practically achievable, a tolerance of +/-1.0 LU is permitted, and QC workflows may allow +/-0.2 LU for measurement error. The maximum true peak level during production linear audio should not exceed -1 dBTP. Verified 2026-07-10: https://tech.ebu.ch/files/live/sites/tech/files/shared/r/r128.pdf
- ATSC A/85:2026-07 quick reference lists -24 LKFS as the target for delivery/exchange without metadata where no prior arrangement exists, -2 dBTP maximum true peak, and a -23 to -27 LKFS range for streaming delivery services unless parties arrange otherwise. Verified 2026-07-10: https://www.atsc.org/wp-content/uploads/2026/07/A85-2026-07-Annex-M.pdf
- AES TD1008 recommends, for internet audio streaming/on-demand distribution, maximum true peak not exceeding -1 dBTP at the lossy codec input, with examples such as speech/assorted content around -18 LUFS, track-normalized music at -16 LUFS, album loudest track at -14 LUFS, interstitials at -18 LUFS, and format examples from -16 to -18 LUFS. Verified 2026-07-10: https://aes.org/wp-content/uploads/2024/01/20210924_TD1008_v3.13.pdf
- Spotify for Artists recommends targeting -14 dB integrated LUFS and keeping true peak below -1 dBTP; if a master is louder than -14 LUFS, Spotify recommends keeping true peak below -2 dBTP. Verified 2026-07-10: https://support.spotify.com/us/artists/article/loudness-normalization/
- Apple Podcasts recommends overall loudness around -16 dB LKFS with +/-1 dB tolerance and true peak not exceeding -1 dB FS, calculated according to ITU-R BS.1770-5. Verified 2026-07-10: https://podcasters.apple.com/support/893-audio-requirements
- YouTube's official upload encoding help lists recommended upload audio bitrates: mono 128 kbps, stereo 384 kbps, 5.1 512 kbps, and immersive audio at 128 kbps per channel. The same official page does not state a public loudness target. Verified 2026-07-10: https://support.google.com/youtube/answer/1722171
- Netflix branded sound mix specifications require -27 LKFS +/-2 LU dialog-gated loudness, true peaks not exceeding -2 dB True Peak, and 48 kHz/24-bit for original language mix or M&E mix masters. Verified 2026-07-10: https://partnerhelp.netflixstudios.com/hc/en-us/articles/360001794307-Netflix-Sound-Mix-Specifications-Best-Practices-v1-6
- WCAG 2.2 understanding guidance for low/no background audio says background sounds should be at least 20 dB lower than foreground speech, except brief sounds, to support users who are hard of hearing. Verified 2026-07-10: https://www.w3.org/WAI/WCAG22/Understanding/low-or-no-background-audio.html
- FFmpeg's
loudnormfilter implements EBU R128 loudness normalization, supports single- and double-pass operation, can target integrated loudness, loudness range, and true peak, and upsamples to 192 kHz in dynamic mode for true-peak detection. Verified 2026-07-10: https://ffmpeg.org/ffmpeg-filters.html#loudnorm
Bundled loudness measurement tool
Use scripts/measure_loudness.py when an agent needs a repeatable local measurement before making mix or delivery decisions. It requires Python 3.11+ and an ffmpeg executable with the loudnorm filter. The script invokes FFmpeg with an argument array rather than a shell, selects the first audio stream, and emits stable JSON. It never normalize