audio-jingle — скилл для Claude Code: генерация аудио и как установить
Скилл audio-jingle генерирует джинглы, озвучку и звуковые эффекты. Маршрутизирует запросы на музыку в Suno V5, Udio или Lyria, речь — в MiniMax TTS или ElevenLabs V3, эффекты — в ElevenLabs SFX или AudioCraft.
Apache-2.0 211 установок ★ 108 855 обновлён 2026-10-25
npx skills add nexu-io/open-design --skill audio-jingle -a claude-codeЧто делает audio-jingle
Скилл работает в трёх режимах. Параметр audioKind в метаданных проекта определяет, какой запускается: music вызывает Suno V5 по умолчанию, speech — MiniMax TTS, sfx — ElevenLabs SFX. Длительность задаётся через audioDuration в секундах, для речи можно указать voice — идентификатор голоса провайдера. Скилл формирует промпт под выбранную модель и запускает единый диспетчер через od media generate, который сохраняет MP3 или WAV в папку проекта.
Для музыки план включает жанр, темп, инструменты и вокал (если нужен). Для речи — финальный текст, который TTS озвучит дословно, включая запятые. Для эффектов — текстуру, атаку и длительность. MiniMax TTS требует конкретный voice_id вроде male-qn-qingse, а не описание голоса: если его нет, флаг --voice лучше опустить. Треки короче 30 секунд строятся одной секцией, от 30 до 90 — вступление и тело, длиннее — полная дуга.
Какие задачи решает
- сгенерировать джингл для запуска кофейни за 30 секунд
- озвучить скрипт голосом MiniMax TTS
- создать звуковой эффект с заданной атакой и длительностью
- маршрутизировать запрос на музыку в Suno, Udio или Lyria
- сохранить готовый аудиофайл в проект и показать плеер
Примеры запросов агенту
- Сделай 30-секундный инди-поп джингл для кофейни — тёплое электропиано, лёгкие барабаны, бас, хор на припеве, без слов
- Озвучь этот скрипт голосом
male-qn-qingse, длительность 45 секунд - Создай звуковой эффект удара — резкая атака, 2 секунды, один слой
Как установить audio-jingle
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill audio-jingle -a claude-code2Вручную: положить файлы
~/.claude/skills/audio-jingle/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/audio-jingle/
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill audio-jingle -a codex2Вручную: положить файлы
.agents/skills/audio-jingle/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill audio-jingle -a cursor2Вручную: положить файлы
.cursor/skills/audio-jingle/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nexu-io/open-design design-templates/audio-jingle/SKILL.md2Вручную: положить файлы
.github/skills/audio-jingle/SKILL.md1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill audio-jingle -a gemini-cli2Командой платформы
gemini skills install https://github.com/nexu-io/open-design --path design-templates/audio-jingleВручную: положить файлы
.devin/skills/audio-jingle/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill audio-jingle -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об audio-jingle
Как установить audio-jingle в Claude Code?
Выполни npx skills add nexu-io/open-design --skill audio-jingle -a claude-code, файл скилла окажется в ~/.claude/skills/audio-jingle/SKILL.md.
Что делает audio-jingle?
Генерирует музыку, озвучку и звуковые эффекты. Выбирает модель по параметру audioKind в метаданных проекта: для музыки использует Suno V5, Udio или Lyria, для речи — MiniMax TTS, Fish или ElevenLabs V3, для эффектов — ElevenLabs SFX или AudioCraft. Результат сохраняется в проект как MP3 или WAV.
Как задать голос для озвучки в MiniMax TTS?
Укажи конкретный voice_id провайдера в метаданных проекта (например, male-qn-qingse). Если передать описание голоса вместо идентификатора, MiniMax отклонит запрос. Если идентификатора нет, флаг --voice лучше опустить — сработает голос по умолчанию.
Исходный текст
SKILL.md · Apache-2.0
---
name: audio-jingle
description: |
Audio generation skill — jingles, beds, voiceover, and sound effects.
Routes music requests to Suno V5 / Udio / Lyria, speech to MiniMax
TTS / FishAudio / ElevenLabs V3, and SFX to ElevenLabs SFX or
AudioCraft. Output is one MP3/WAV file saved to the project folder.
triggers:
- "music"
- "jingle"
- "bed"
- "voiceover"
- "tts"
- "sound effect"
- "音乐"
- "配音"
- "音效"
od:
mode: audio
surface: audio
scenario: marketing
preview:
type: html
entry: example.html
design_system:
requires: false
example_prompt: |
A 30-second upbeat indie-pop jingle for a coffee shop launch — warm
electric piano lead, brushed drums, gentle bass, a single sun-soaked
"ahhh" choir on the chorus. No vocals. Loop-friendly tail.
---
# Audio Jingle Skill
Three sub-modes. The active project's `audioKind` decides which one
runs:
| `audioKind` | Models we route to | Plan focus |
|---|---|---|
| `music` | Suno V5 (default), Udio, Lyria 2 | genre + tempo + instrumentation |
| `speech` | MiniMax TTS (default), Fish, ElevenLabs V3 | script + voice + pacing |
| `sfx` | ElevenLabs SFX (default), AudioCraft | texture + impact + duration |
## Resource map
```
audio-jingle/
├── SKILL.md
└── example.html
```
## Workflow
### Step 0 — Read the project metadata
`audioKind`, `audioModel`, `audioDuration` (seconds), and (for speech)
`voice`. Branch by known values and use them verbatim. Missing metadata is not
an instruction to ask: infer a safe default when possible, and emit a
clarifying form only when the missing answer would materially change the
requested output or prevent generation.
Important: `voice` is provider-specific. For `minimax-tts`, `--voice`
must be a valid MiniMax `voice_id` (for example `male-qn-qingse`), not
a natural-language description. If you only have a prose voice brief
("warm female narrator", "neutral Mandarin"), keep that in your plan
but omit `--voice` so the daemon's default voice id applies, or ask the
user to choose a specific id.
### Step 1 — Plan
**Music**
- Genre + reference artists (1-2)
- Tempo (BPM) + key
- Instrumentation (3-5 instruments max)
- Vocals: yes / no / hummed / choir
- Mood arc (intro → chorus → outro)
**Speech**
- Script (final, not draft — TTS runs verbatim)
- Voice target + pacing
For MiniMax this means a real `voice_id`, not prose in `--voice`
- Pronunciation hints for proper nouns / acronyms
**SFX**
- Texture (impact / whoosh / ambience / foley)
- Duration + envelope (sharp attack vs. gentle swell)
- Layering note (single hit vs. stacked)
State the plan in 2-3 sentences before dispatching.
### Step 2 — Compose the prompt
Use the format the upstream model prefers. Bind `audioDuration` to the
API parameter directly; never put "make it 30 seconds" in prose.
### Step 3 — Dispatch via the media contract
Use the unified dispatcher — do **not** call provider APIs by hand:
```bash
"$OD_NODE_BIN" "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface audio \
--audio-kind "<music|speech|sfx>" \
--model "<audioModel from metadata>" \
--duration <audioDuration seconds> \
[--voice "<provider voice id (speech only)>"] \
--output "<short-slug>-<duration>s.mp3" \
--prompt "<assembled prompt from Step 2 — for speech, the literal script>"
```
The command prints one line of JSON: `{"file": {"name": "...", ...}}`.
The bytes land in the project; the FileViewer renders the audio
transport controls automatically.
### Step 4 — Hand off
Reply with: plan summary, the filename returned by the dispatcher, and
one sentence on what to try if the user wants a variation (e.g. "swap
tempo from 92 to 108 BPM" rather than "make it different").
## Hard rules
- TTS runs your script **literally**. Proof it before dispatching —
even one stray comma changes the cadence.
- MiniMax TTS rejects free-form voice prose in `--voice`. Use a real
MiniMax `voice_id` (for example `male-qn-qingse`) or omit the flag
and let the daemon's default voice apply.
- Music: under 30s = single section; 30–90s = intro + body; 90s+ =
full arc. Don't try to fit a 3-act song into 15 seconds.
- SFX: prefer one well-described layer over a paragraph of "make it
cool" — generators reward specific texture words.
- Save the file every turn. The audio viewer shows transport controls
the moment the file lands.
© nexu-io · Apache-2.0 · nexu-io/open-design