# add-audio

Скилл добавляет в браузерную игру фоновую музыку и звуковые эффекты на Web Audio API. Никаких аудиофайлов и npm-пакетов — всё синтезируется в браузере.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 установок · ★ 348
- Автор: OpusGameLabs
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/PlayableIntelligence/game-creator/tree/HEAD/skills/add-audio/SKILL.md
- Обновлён: 2026-05-25
- HTML: https://affpapa.org/nevibecode/skills/add-audio

## Что делает

Скилл разбирает существующую игру по указанному пути, смотрит `src/core/EventBus.js` и файлы сцен, а потом предлагает таблицу: какая музыка нужна каждой сцене, какие звуки — каждому событию. Дальше он создаёт `src/audio/AudioManager.js` с инициализацией AudioContext и мастер-гейном, `AudioBridge.js` для связи событий с аудио, `music.js` с паттернами BGM и `sfx.js` с одноразовыми эффектами. Фон играет через step-секвенсер Web Audio и зацикливается, эффекты собираются из OscillatorNode, GainNode и BiquadFilterNode.

Скилл добавляет события `AUDIO_INIT`, `MUSIC_GAMEPLAY`, `MUSIC_GAMEOVER`, `MUSIC_STOP` и `AUDIO_TOGGLE_MUTE` в шину событий, подключает `initAudioBridge()` в `main.js` и вешает переключатель mute на кнопку и клавишу M. В конце он прогоняет `npm run build` и перечисляет созданные файлы.

Главная засада — политика автовоспроизведения браузеров: до первого клика, тапа или нажатия клавиши звука не будет, поэтому AudioContext нужно возобновлять по первому вводу пользователя. Второе: не создавайте новые узлы в игровом цикле, иначе пойдут просадки по кадрам — эффекты должны быть одноразовыми, а музыка держится на одном зацикленном секвенсоре. Скилл берётся только за звук; геймплей и визуал он не трогает.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PlayableIntelligence/game-creator --skill add-audio -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/add-audio/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/add-audio/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PlayableIntelligence/game-creator --skill add-audio -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/add-audio/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PlayableIntelligence/game-creator --skill add-audio -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/add-audio/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PlayableIntelligence/game-creator add-audio
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/add-audio/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PlayableIntelligence/game-creator --skill add-audio -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/PlayableIntelligence/game-creator --path skills/add-audio
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/add-audio/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add PlayableIntelligence/game-creator --skill add-audio -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/PlayableIntelligence/game-creator/tree/HEAD/skills/add-audio/SKILL.md

## Когда брать
- добавить фоновую музыку в сцены браузерной игры
- озвучить прыжок, набор очков и смерть персонажа
- сделать зацикленный BGM без аудиофайлов
- повесить переключатель mute на клавишу M
- связать игровые события с звуками через шину событий

## Примеры запросов агенту
- /add-audio examples/flappy-bird
- добавь музыку и звуковые эффекты в игру по пути src/game
- сделай звук в игре — фон для сцен и эффекты на события

## Похожие
- [videoagent-audio-studio](https://affpapa.org/nevibecode/skills/videoagent-audio-studio.md) — скилл · 3900 установок
- [web-audio-api](https://affpapa.org/nevibecode/skills/web-audio-api.md) — скилл · 395 установок
- [scenario-sonilo](https://affpapa.org/nevibecode/skills/scenario-sonilo.md) — скилл · 380 установок
- [venice-audio-music](https://affpapa.org/nevibecode/skills/venice-audio-music.md) — скилл · 2800 установок
- [audio-and-sound](https://affpapa.org/nevibecode/skills/audio-and-sound.md) — скилл · 944 установки
- [sound-effects](https://affpapa.org/nevibecode/skills/sound-effects.md) — скилл · 11400 установок

Из того же набора: [playableintelligence/game-creator](https://affpapa.org/nevibecode/by/playableintelligence/game-creator.md) — 27 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md