agentleFS
godot-fungodot-fun/gai/.agents/skills/audio-fade/SKILL.md

audio-fade

Skill210 starsChanged 2 days agoMITView on GitHub

Applies fade-in and fade-out at the start and end of a single audio file using FFmpeg. Use when the user wants audio fade, fade in/out, smooth attack/release, crossfade prep, SFX envelope shaping, or mentions afade.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 0 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    When this skill applies, read and follow dependency-manager — run scripts as documented, install missing tools into .dependency/.

    line 12
  2. Very specific:

    Default: 1 s fade-in and fade-out, output to <audio-dir>/audio-fade/<audio-name>:

    line 16
  3. Very specific:

    Use the bundled script, not hand-written afade filters.

    line 66

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Audio Fade

Apply fade-in at the start and fade-out at the end without changing clip length.

Rules

When this skill applies, read and follow dependency-manager — run scripts as documented, install missing tools into .dependency/.

Quick Start

Default: 1 s fade-in and fade-out, output to <audio-dir>/audio-fade/<audio-name>:

.dependency/python/python .ai/audio-fade/fade.py --audio path/to/audio.wav

Fade-in only (keep full end level):

.dependency/python/python .ai/audio-fade/fade.py --audio path/to/audio.wav --no-fade-out

Custom durations (seconds):

.dependency/python/python .ai/audio-fade/fade.py --audio audio/sfx.wav -fi 0.05 -fo 0.15

Duration Guidelines

AssetFade-inFade-out
UI clicks / ticks0.01–0.05 s0.02–0.08 s
Impacts / weapons0.02–0.08 s0.05–0.15 s
Voice lines0.05–0.15 s0.1–0.25 s
Ambience beds0.3–1.0 s0.5–2.0 s
BGM one-shots0.2–0.5 s0.3–1.0 s

Fade-in + fade-out must stay shorter than file duration. Very short clips need smaller values.

Common Flags

--audio · -fi / --fade-in · -fo / --fade-out · --no-fade-in · --no-fade-out · -o / --output

.dependency/python/python .ai/audio-fade/fade.py --audio audio/sfx.wav -fi 0.03 -fo 0.08

Originals are never modified. Input must be a single audio file (--audio), not a directory. Supported: .wav, .mp3, .ogg, .flac, .aac, .m4a, .wma.

Fades use FFmpeg afade with the linear tri curve. The script probes clip duration and places fade-out at duration - fade_out.

Scope

  • Fade shapes volume at clip boundaries without changing its duration.
  • Trim removes silence or crops boundaries; use the audio-trim skill.
  • Crossfade overlaps two clips and is not performed by this skill.

Agent Notes

  1. Use the bundled script, not hand-written afade filters.
  2. Looping BGM — avoid fade-out on loop assets; use --no-fade-out or fade-in only for one-shot intros.
  3. Clicks with instant attack → --no-fade-in or lower -fi (e.g. 0.01).
  4. Tail cut off abruptly after fade → increase -fo; tail too soft → decrease -fo.

CLI

Copy-paste commands: cli/audio-fade.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.