# audio-quality-controller

audio-quality-controller inspects audio files, trims noise, and normalizes loudness to broadcast levels via FFmpeg. Built for podcast production and clean vocal pipelines.

- subagent · `type=agent` · Claude Code, Codex, Cursor · 547 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/ffmpeg-clip-team/audio-quality-controller.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/audio-quality-controller

## What it does

This subagent inspects recorded tracks inside Claude Code to reach broadcast-ready output. It evaluates metrics such as integrated LUFS, True Peak ceilings, loudness range (LRA), and signal-to-noise ratios. For podcast files, it aims around -16 LUFS and -1.5 dBTP.

The assistant relies on `Bash`, `Read`, and `Write` permissions to assemble and run `ffmpeg` filter chains. It applies multi-stage audio processing: high-pass filters for rumble, de-essing between 5-8 kHz, gentle compression ratios, and `loudnorm` passes. Following each run, it compiles a structured JSON review covering detected flaws, before-and-after readings, and a 1-to-10 improvement score.

Without `ffmpeg` installed in your system `PATH`, this agent will fail completely because every inspection and filter step runs through shell commands. Working with uncompressed audio like WAV or FLAC gives the cleanest results.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent ffmpeg-clip-team/audio-quality-controller
```

2. **Manually: put the files in place**
- File: `.claude/agents/audio-quality-controller.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/audio-quality-controller.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/audio-quality-controller.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/ffmpeg-clip-team/audio-quality-controller.md

## When to use it
- normalize podcast loudness to standard target levels like -16 LUFS
- cut background hum and room resonance with high-pass filtering
- tame harsh sibilance using parametric equalization
- generate detailed JSON reports covering True Peak and dynamic range

## Example prompts
- Analyze `episode1.wav` and normalize the loudness to -16 LUFS.
- Remove low-end rumble and excessive sibilance from `recording.wav`.
- Process `interview.flac` through the complete compression chain and output a JSON quality report.

## Similar
- [audio-mixing-mastering](https://affpapa.org/en/nevibecode/skills/audio-mixing-mastering.md) — skill · 555 installs
- [ffmpeg-audio-processing](https://affpapa.org/en/nevibecode/skills/ffmpeg-audio-processing.md) — skill · 195 installs
- [audio-producer](https://affpapa.org/en/nevibecode/skills/audio-producer.md) — skill · 200 installs
- [audio-processing](https://affpapa.org/en/nevibecode/skills/audio-processing.md) — skill · 176 installs
- [audio-voice-recovery](https://affpapa.org/en/nevibecode/skills/audio-voice-recovery.md) — skill · 360 installs
- [extract-audio](https://affpapa.org/en/nevibecode/skills/extract-audio.md) — skill · ★ 276 repo stars

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 745 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
