Audio Volume Adjust
Adjusts audio file volume up or down using FFmpeg. Use when the user wants to change volume, boost or reduce loudness, attenuate or amplify SFX/UI/BGM, apply dB gain, raise/lower clip levels, or batch-adjust audio amplitude.
Get the complete skill folder, including its scripts and reference files.
When to use this skill
Use Audio Volume Adjust when an AI agent needs a reusable SKILL.md workflow for this job: Adjusts audio file volume up or down using FFmpeg. Use when the user wants to change volume, boost or reduce loudness, attenuate or amplify SFX/UI/BGM, apply dB gain, raise/lower clip levels, or batch-adjust audio amplitude.
When not to use it
Skip Audio Volume Adjust when the task is outside the writing category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.
How to install
Where will you use it?
mkdir -p ~/.claude/skills/audio-volume-adjust # Save SKILL.md to ~/.claude/skills/audio-volume-adjust/SKILL.md
- Claude Code personal install: place the skill and its bundled files at ~/.claude/skills/audio-volume-adjust/SKILL.md. For a shared project, commit the folder at .claude/skills/audio-volume-adjust/ instead.
- Current Claude Code detects SKILL.md changes in watched directories during the session. If you just created a top-level skills directory, run /reload-skills. Check that the skill is listed before testing its trigger.
- For Claude chat or Cowork in the Desktop app, manage uploaded skills in Customize > Skills; copying files into a local Claude Code folder is not a Desktop install. Other agents may use different install locations.
Full install guide for Claude, Cursor, and Codex →
Try a starter prompt
After installing the skill, paste this starter prompt into your agent to verify it triggers on a small task.
Use the Audio Volume Adjust skill for this task: Use Audio Volume Adjust when this documented workflow matches the task. Confirm any required inputs or files before making changes.
What supports this recommendation?
70/100 provisional content score. This measures documentation, practical detail and source signals. It is not a measured task success rate or a security certification.
- Documentation
- 77/100
- Practical detail
- 68/100
- Source evidence
- 61/100
- Source signals
- 72/100
Model compatibility evidence
- claudeuntested
No model-specific signal or recorded compatibility test was found.
- chatgptuntested
No model-specific signal or recorded compatibility test was found.
- geminiuntested
No model-specific signal or recorded compatibility test was found.
- copilotuntested
No model-specific signal or recorded compatibility test was found.
- llamauntested
No model-specific signal or recorded compatibility test was found.
- perplexityuntested
No model-specific signal or recorded compatibility test was found.
- mistraluntested
No model-specific signal or recorded compatibility test was found.
- grokuntested
No model-specific signal or recorded compatibility test was found.
Inferred compatibility is based on content signals. Check the app, its available tools and setup requirements before running a skill.
What this skill does
# Audio Volume Adjust
Apply a uniform **gain change** across the full clip — no fade, no loudness targeting. Negative dB reduces level; positive dB increases it.
## Rules
When this skill applies, read and follow [skill-dependency-manager](../skill-dependency-manager.md) — run scripts as documented, install missing tools into `.dependency/`.
## Quick Start
Reduce by 6 dB (~half amplitude), output to `<audio-dir>/audio-volume-adjust/<audio-name>`:
```bash .dependency/python/python .ai/audio-volume-adjust/adjust.py --audio path/to/audio.wav --volume -6 ```
Example: `audio/sfx/tank/tank_move.wav` → `audio/sfx/tank/audio-volume-adjust/tank_move.wav`
Boost by 3 dB:
```bash .dependency/python/python .ai/audio-volume-adjust/adjust.py --audio audio/sfx.wav --volume 3 ```
## Adjustment Guidelines
| Goal | `--volume` (dB) | |------|-----------------| | Slight reduction | -3 | | Half amplitude | -6 | | Noticeably quieter | -9 to -12 | | Background / distant | -15 to -20 | | Slight boost | +3 | | Noticeably louder | +6 |
## Common Flags
`--audio` · `--volume` · `-o` / `--output`
```bash .dependency/python/python .ai/audio-volume-adjust/adjust.py --audio audio/sfx.wav --volume -9 ```
Originals are never modified. Input must be a single audio file (`--audio`), not a directory. Supported: `.wav`, `.mp3`, `.ogg`, `.flac`, `.aac`, `.m4a`, `.wma`.
## Agent Notes
1. Use the bundled script, not hand-written `volume` filters. 2. Always pass `--volume` in dB (negative = reduce, positive = boost). 3. Missing Python/FFmpeg → populate `.dependency/` per skill-dependency-manager, retry same command. 4. **Do not copy, move, or replace the source with the adjusted output** — tell the user where `audio-volume-adjust/` files are; they swap assets manually when ready. 5. Do not use `--output` pointing at the source file; the script refuses output paths that would overwrite inputs. 6. **Boosting** (positive dB) can clip peaks — warn the user; prefer small boosts (+3 dB or less). 7. FFmpeg filter details and dB math: [reference.md](reference.md)
## CLI
Copy-paste commands: [cli/audio-volume-adjust.md](../../../cli/audio-volume-adjust.md)
Intended uses
- Use Audio Volume Adjust when this documented workflow matches the task.
Implementation notes
- Review the source instructions and adapt inputs before running the workflow.
Try it, then tell us how it went
A copied prompt does not tell us whether the task worked. Report your result after checking the output. We collect your tool and outcome, never your files or prompt.