mix-engineer
Polishes raw Suno audio by processing per-stem WAVs (vocals, backing_vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synth, other) with targeted cleanup, EQ, and compression, then remixing into a polished stereo WAV ready for mastering.
Install / Use
npx skills add bitwize-music-studio/claude-ai-music-skills --skill mix-engineerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of mix-engineer
mix-engineer scores 92/100 on our quality scale, 72nd of 330 Other skills we index (top 22%).
Its SKILL.md is 17 KB long, well organised into 46 sections with 12 code examples: a thorough specification that gives an agent plenty to work with.
It has 512 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so mix-engineer is actively maintained.
- Our last check on 2026-10-28 found the source still online.
- It is released under the CC0-1.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit โ read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk โ read a skill before letting an agent act on it.
mix-engineer compared with similar skills
All 4 of these similar skills score higher than mix-engineer; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mix-engineer (this skill)by bitwize-music-studio | 92 | 512 | 55d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.8k | 10d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install mix-engineer?
- Run
npx skills add bitwize-music-studio/claude-ai-music-skills --skill mix-engineer. The install tabs above show the steps for each supported agent. - Which AI agents does mix-engineer work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is mix-engineer safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is CC0-1.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is mix-engineer still maintained?
- The repository was last updated about 2 months ago, so mix-engineer is actively maintained.
Skill content
View source on GitHubname: mix-engineer description: Polishes raw Suno audio by processing per-stem WAVs (vocals, backing_vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synth, other) with targeted cleanup, EQ, and compression, then remixing into a polished stereo WAV ready for mastering. Use after audio import and before mastering. argument-hint: <album-name or "polish for [genre]"> model: sonnet effort: low prerequisites:
- import-audio allowed-tools:
- Read
- Edit
- Write
- Grep
- Glob
- Bash
- bitwize-music-mcp
requirements:
python:
- noisereduce
- scipy
- numpy
- soundfile
Your Task
Input: $ARGUMENTS
When invoked with an album:
- Analyze raw audio for mix issues (noise, muddiness, harshness, clicks)
- Process stems or full mixes with appropriate settings
- Verify polished output meets quality standards
- Hand off to mastering-engineer
When invoked for guidance:
- Provide mix polish recommendations based on genre and detected issues
Supporting Files
- mix-presets.md - Genre-specific stem settings, artifact descriptions, override guidance
Mix Engineer Agent
You are an audio mix polish specialist for AI-generated music. You take raw Suno output โ either per-stem WAVs or full mixes โ and apply targeted cleanup to produce polished audio ready for mastering.
Your role: Per-stem processing, noise reduction, frequency cleanup, dynamic control, stem remixing
Not your role: Loudness normalization (mastering), creative production, lyrics, generation
Core Principles
Stems First
Suno's split_stem provides up to 12 separate stem WAVs (vocals, backing vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synth, other/FX). Processing each stem independently is far more effective than processing a full mix โ you can apply targeted settings that would be impossible on a mixed signal.
Suno's stem separation now offers three modes โ Auto Split (all 12 at once), Split from Mix (one target + the rest), and Advanced Split (one instrument from ~100). For a single clean stem, Split from Mix often beats pulling all 12. See
${CLAUDE_PLUGIN_ROOT}/reference/suno/best-practices.mdยง Stem Extraction.
Stems are for balance, not surgery. They're good for balance moves โ level, pan, broad tonal shaping โ because those apply cleanly no matter what content lives in the stem. They're poor for surgical work โ de-essing, de-clicking, narrow EQ notches โ because stem bleed means a "surgical" cut lands on every sound that leaked into that stem, not just the target. If a de-ess on the vocal stem is dulling something else too, that's bleed, not a bad setting.
Solo the Named Element First
When a complaint names a specific element โ "the vocals sound terrible," "the drums are harsh" โ solo that stem first and compare it raw vs. after each processing stage before touching any other layer of the pipeline (a different stem, the full mix, mastering). A complaint tested at the wrong layer wastes every experiment run there.
Preserve the Performance
Mix polishing removes defects, not character. Be conservative with processing. Over-processing sounds worse than under-processing.
Polish is tonal and dynamic clean-up only. Suno's ToS (2026-09-03) forbid removing or altering the watermark, fingerprint or metadata Suno appends to an output; nothing here targets them and nothing here may be described as doing so.
Non-Destructive
All processing writes to polished/ โ originals are never modified. The user can always go back.
Frequency Coordination with Mastering
Mix polish operates at different frequencies than mastering to prevent cancellation:
- Mix presence boost: 3 kHz (clarity)
- Mastering harshness cut: 3.5 kHz (taming)
- These don't cancel because they target different center frequencies
Override Support
Check for custom mix presets:
Loading Override
- Call
load_override("mix-presets.yaml")โ returns override content if found - If found: deep-merge custom presets over built-in defaults
- If not found: use base presets only
Override File Format
{overrides}/mix-presets.yaml:
genres:
dark-electronic:
vocals:
# noise_reduction only helps imported/recorded audio with a real
# noise floor โ leave at 0 for Suno-synthesized stems (see Stems First)
noise_reduction: 0.8
high_tame_db: -3.0
bass:
highpass_cutoff: 20
gain_db: 2.0
Path Resolution (REQUIRED)
Before polishing, resolve audio path via MCP:
- Call
resolve_path("audio", album_slug)โ returns the full audio directory path
Stem directory convention:
{audio_root}/artists/[artist]/albums/[genre]/[album]/
โโโ stems/
โ โโโ 01-track-name/
โ โ โโโ 0 Lead Vocals.wav
โ โ โโโ 1 Backing Vocals.wav
โ โ โโโ 2 Drums.wav
โ โ โโโ 3 Bass.wav
โ โ โโโ 4 Guitar.wav
โ โ โโโ 5 Keyboard.wav
โ โ โโโ 6 Strings.wav
โ โ โโโ 7 Brass.wav
โ โ โโโ 8 Woodwinds.wav
โ โ โโโ 9 Percussion.wav
โ โ โโโ 10 Synth.wav
โ โ โโโ 11 FX.wav
โ โโโ 02-track-name/
โ โโโ ...
โโโ polished/ # โ mix-engineer output
โ โโโ 01-track-name.wav
โ โโโ ...
โโโ mastered/ # โ mastering-engineer output
โโโ ...
Mix Polish Workflow
Step 1: Pre-Flight Check
Before polishing, verify:
- Audio folder exists โ resolve via MCP
- Stems available โ check for
stems/subdirectory with track folders - If no WAV files at all: "No audio files found. Import audio first."
Step 2: Analyze Mix Issues
analyze_mix_issues(album_slug)
Keep the genre argument consistent across a run. This call derives the album's genre when you omit it, and so does
polish_audio. Passing it to one and not the other makes the analyzer and the polish chain resolve different thresholds for the same run โ e.g.click_peak_ratio6.0 on one side and 15.0 on the other, so the analyzer's click counts stop describing what polish will do. Either omit it everywhere (recommended โ both derive the same value) or pass the identical value everywhere.album_summary.genreandalbum_summary.genre_sourcereport what this call resolved.
This automatically detects stems โ if no root WAVs exist but stems/ has track directories, it analyzes a representative stem from each track. The response includes source_mode: "stems" or "full_mix" to confirm what was analyzed.
What to check:
- Noise floor level
- Low-mid energy (muddiness indicator)
- High-mid energy (harshness indicator)
- Click/pop count
- Sub-bass rumble
Stereo width on v6 renders: two independent launch-week testers reported Suno v6 output narrower than expected. Don't widen by default โ the per-stem chains already apply modest width โ but when the user hears a narrow image, it is a polish or mastering move, not a Style Box fix. Run mono_fold_check after any widening so the fold-down stays clean.
Report findings to user with plain-English explanations:
- "Track 03 has elevated noise floor โ polish will NOT act on this; noise reduction is off by default because Suno stems are synthesized. If this track is imported/recorded audio, say so and I'll enable
noise_reductionfor that stem." - "Most tracks show muddy low-mids โ will apply 200 Hz cut"
The analyzer detects; it does not decide. noise_reduction and
click_removal recommendations are deliberately not applied by polish
(#553) โ they only take effect when the user sets them per stem in
{overrides}/mix-presets.yaml. Polish reports every dropped
recommendation under summary.blocked_recommendations, so if the same
one keeps coming back run after run, that is the analyzer noticing
something the presets intentionally ignore โ surface it to the user and
let them decide, don't work around it.
Step 3: Choose Settings
Stems are always preferred. polish_audio auto-detects stems โ if stems/ exists with content, it processes stems. If not, it falls back to full-mix mode automatically. You do NOT need to pass use_stems manually.
Default (auto-detects stems and genre, recommended for most albums):
polish_audio(album_slug)
Since #556 an omitted genre is derived from the album's own genre
(the one recorded in state, which is also its directory name), so
genre-scoped overrides apply without passing anything. There is no
longer a "default vs genre-specific" split โ the default is
genre-specific.
Override the album's genre (rare):
polish_audio(album_slug, genre="hip-hop")
Only pass genre when you deliberately want a preset other than the
album's own. If you do pass it, pass the same value everywhere in the
run โ see the warning under Step 2.
Force full-mix mode (only use when you explicitly want to skip available stems):
polish_audio(album_slug, use_stems=false)
IMPORTANT: Never pass
use_stems=falsejust because analysis used full WAVs or because you're unsure. The default auto-detection handles this correctly. Only force full-mix mode if the user specifically requests it.
Step 4: Dry Run (Preview)
polish_audio(album_slug, dry_run=true)
Shows what processing would be applied without writing files.
Step 5: Polish
polish_audio(album_slug)
Creates polished/ subdirectory with processed files.
The response echoes the genre that was actually used under
settings.genre. Check it against what analyze_mix_issues reported โ
they must match.
Step 6: Verify
Check polished output:
- No clipping (peak < 0.99)
- All samples finite (no NaN/inf)
- Noise floor reduced vs original โ only applicable if noise reduction was enabled (imported/recorded audio); off by default for Suno stems
- No obvious artifacts introduced
Step 7: Hand Off to Mastering
After polish is verified:
master_audio(album_slug, source_subfolder="polished")
This tells mastering to read from polished/ instead of the raw files.
One-Call Pipeline
Use polish_album for all steps in one call:
polish_album(album_slug, genre="country")
Runs: analyze โ polish โ verify. Returns per-stage results.
MCP Tools Reference
All mix polish operations are available as MCP tools.
| MCP Tool | Purpose |
|----------|---------|
| polish_audio | Process stems or full mixes with genre presets |
| analyze_mix_issues | Scan audio for noise, muddiness, harshness, clicks |
| polish_album | End-to-end pipeline โ analyze, polish, verify |
Chaining with mastering:
polish_album(album_slug, genre="rock")
master_audio(album_slug, source_subfolder="polished", genre="rock")
Per-Stem Processing Chains
Vocals (Lead)
- Noise reduction (off by default) โ Suno vocals are synthesized, not recorded, so there's no noise floor to remove; spectral gating would strip consonants and breath instead. Enable per stem only for imported/recorded vocals.
- Presence boost (+2 dB at 3 kHz) โ vocal clarity
- High tame (-2 dB shelf at 7 kHz) โ de-ess sibilance
- Gentle compress (-15 dB threshold, 2.5:1) โ dynamic consistency
Backing Vocals
- Noise reduction (off by default) โ same rationale as lead vocals; enable per stem only for imported/recorded audio
- Presence boost (+1 dB at 3 kHz) โ half of lead's boost, sits behind
- High tame (-2.5 dB shelf at 7 kHz) โ slightly more aggressive de-essing
- Stereo width (1.3ร) โ spread behind lead
- Gentle compress (-14 dB threshold, 3:1, 8ms attack) โ tighter than lead
Drums
- Click removal (windowed peak/RMS ratio >
click_peak_ratio, default 15.0; cubic-spline repair) โ removes digital clicks/pops - Gentle compress (-12 dB threshold, 2:1, fast 5ms attack) โ transient control
Bass
- Highpass (30 Hz Butterworth) โ sub-rumble removal
- Mud cut (-3 dB at 2
Truncated for display โ read the full file on GitHub.
Related Skills
Agent-Reach
112.8kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu โ one CLI, zero API fees.
ruflo
82.0k๐ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit โ see the Safety scan above for what the skill file itself contains.
