audio-mix SKILL.md skillA
audio-mix from zju-real/easel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add zju-real/easel/audio-mix@git:20261012.0d53744Pins git:20261012.0d53744 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- zju-real/easel
- Path
skills/builtin/audio-mix/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261012.0d53744, committed Oct 12, 2026
- Size
- 3,299 bytes
- Repository stars
- 3,982
- License
- Apache-2.0
音频混合 / 混音：把旁白口播 + 背景音乐 + 音效混成一轨，BGM 自动循环补足并可闪避（旁白说话时自动压低 BGM 保证人声清晰）。当用户说 混音、音频混合、旁白加背景音乐、配音加BGM、人声和音乐混一起、加音效、音频叠加、BGM 压低、闪避、ducking、把配音和bgm合起来 时使用。基于 shared/scripts/audio_mix.py。与 audio-editing concat 区别：concat 是前后顺序拼接，本 SKILL 是同时叠加混音；与 video-editing bgm 区别：那个给视频配乐，本 SKILL 输出纯音频。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 音频混合（旁白 + BGM + 音效） > 把多条音频**同时叠加**混成一轨，核心能力是**闪避（ducking）**——旁白说话时自动压低 > 背景音乐，人声清晰、音乐不抢。全部走 `skills/shared/scripts/audio_mix.py`， > **不要手拼 amix/sidechaincompress**。 > 前后顺序拼接（一段接一段）见 **audio-editing** `concat`；给视频配乐见 **video-editing** `bgm`； > 降噪见 **audio-denoise**。 ## 输入 | 字段 | 必填 | 说明 | |------|------|------| | 旁白 | 否 | 口播/配音主轨（给了则输出时长跟它走，并触发闪避） | | BGM | 否 | 背景音乐（自动循环补足到旁白长度） | | 音效 | 否 | 一个或多个音效，可指定各自出现时间点 | （三者至少给一个。最典型："旁白 + BGM"。） ## 输出（`outputs/主题名/`） - 混音后的单轨音频（mp3/wav/m4a，按输出后缀） - 报告：轨数、时长、是否闪避 ## 执行步骤 脚本路径（相对项目根）：`skills/shared/scripts/audio_mix.py`（`mix -h` 看参数）。 ```bash # 旁白 + BGM（默认自动闪避，BGM 循环补足到旁白长度） python skills/shared/scripts/audio_mix.py mix \ --voice narration.mp3 --bgm music.mp3 --bgm-volume 0.25 \ -o outputs/主题名/final.mp3 # 关闭闪避（纯叠加） python skills/shared/scripts/audio_mix.py mix --voice v.mp3 --bgm m.mp3 --no-duck -o out.mp3 # 旁白 + 定时音效（第 3.5s 一个叮，第 8s 一个 whoosh） python skills/shared/scripts/audio_mix.py mix --voice v.mp3 \ --sfx ding.wav --sfx-at 3.5 --sfx whoosh.wav --sfx-at 8 -o out.mp3 ``` ## 调参 - **人声被音乐盖住**：调低 `--bgm-volume`（默认 0.25）或确认闪避已开（默认开）。 - **闪避太猛/音乐一顿一顿**：`--no-duck` 后手动压低 `--bgm-volume`。 …
Read the whole file at its exact version.
How to install
mdr add zju-real/easel/audio-mix@sha256:f4a017f4c6ca0142The line at the top of this page pins the label git:20261012.0d53744, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_r4umyrog23jnpbao)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 12, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3299 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
zju-real/easel · 3,982 stars · license Apache-2.0 · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_r4umyrog23jnpbao GET https://markdownregistry.com/api/v1/resolve?ref=zju-real/easel/audio-mix GET https://markdownregistry.com/api/v1/blob/f4a017f4c6ca0142144f9227f4e8e38f526eb0d1caae2ae34ff372f081baf03d
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.