threejs-audio — скилл для Claude Code: что делает и как установить
Скилл threejs-audio для Claude Code настраивает пространственный звук в Three.js. Помогает привязать слушателя к камере, обойти блокировку автоплея и связать аудио с жизненным циклом сцены.
MIT 583 установок ★ 26 обновлён 2026-09-10
npx skills add cesartevisual/threejs-skills --skill threejs-audio -a claude-codeЧто делает threejs-audio
Скилл инструктирует агента по добавлению пространственного звука в проектах на Three.js. Он предписывает запускать воспроизведение только по клику или другому действию пользователя, чтобы браузер не блокировал звук, и связывать слушателя AudioListener с активной камерой без дублирования шин вывода.
Для позиционных источников скилл требует задавать конусы направленности и спад громкости в единицах сцены. Моделирование окклюзии стен автоматически не поддерживается: Three.js не глушит звук за преградами из коробки. Буферы звуков переиспользуются, а воспроизведение не должно срабатывать на каждом кадре столкновения.
При смене маршрута, сворачивании вкладки или переходе в сессию WebXR воспроизведение координируется с состоянием страницы. Скилл запрещает закрывать общий AudioContext, если он используется другими частями приложения.
Какие задачи решает
- привязать
AudioListenerк активной камере без дублирования вывода - настроить позиционирование звука и конусы направленности для объектов сцены
- обработать блокировку автоплея браузером при загрузке страницы
- освободить аудиоресурсы при размонтировании компонента или смене сцены
Примеры запросов агенту
- Добавь пространственный звук шагов к персонажу в Three.js
- Настрой запуск фонового звука по первому клику пользователя и добавь кнопку отключения звука в HTML
- Организуй очистку аудиоисточников и слушателя при переходе на другой роут
Как установить threejs-audio
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-audio -a claude-code2Вручную: положить файлы
~/.claude/skills/threejs-audio/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/threejs-audio/
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-audio -a codex2Вручную: положить файлы
.agents/skills/threejs-audio/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-audio -a cursor2Вручную: положить файлы
.cursor/skills/threejs-audio/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cesartevisual/threejs-skills skills/threejs-audio2Вручную: положить файлы
.github/skills/threejs-audio/SKILL.md1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-audio -a gemini-cli2Командой платформы
gemini skills install https://github.com/cesartevisual/threejs-skills --path skills/threejs-audioВручную: положить файлы
.devin/skills/threejs-audio/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-audio -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о threejs-audio
Как установить threejs-audio в Claude Code?
Выполните команду npx skills add cesartevisual/threejs-skills --skill threejs-audio -a claude-code в терминале.
Что делает threejs-audio?
Задаёт правила работы с Web Audio и PositionalAudio в Three.js: от привязки слушателя к камере до корректной остановки звуков при смене видимости вкладки или переходе в XR.
Учитывает ли threejs-audio препятствия и стены сцены?
Нет, позиционные источники в Three.js не рассчитывают окклюзию стен автоматически, поэтому физические преграды требуют отдельной логики.
Исходный текст
SKILL.md · MIT
--- name: threejs-audio description: "Add Three.js spatial audio, user-controlled playback, listener movement, and audio lifecycle handling." --- # Spatial Audio Use the project's installed versions and existing architecture. These instructions supplement the user's task; they do not authorize unrelated changes or external actions. Establish whether audio communicates information or provides optional ambience. Expose mute/volume and any required textual equivalent in HTML. Start or resume audio from a user interaction and handle autoplay rejection without breaking the scene. Attach the listener to the active viewpoint and handle camera changes without duplicating listeners or output paths. For positional sources, choose distance/rolloff and directional cones in the scene's units. A positional source does not automatically simulate wall occlusion. Load and decode asynchronously with explicit failure and stale-result handling. Bound concurrent sources and reuse buffers where appropriate. Avoid replaying a sound on every frame of a collision; trigger from meaningful state transitions. Coordinate pause, visibility changes, route transitions, and XR session transitions with playback. Stop/disconnect owned sources and release listeners. Do not close an AudioContext shared with another part of the application. Verify blocked autoplay, first interaction, mute persistence, moving-camera attenuation, rapid retriggers, and repeated mount/unmount. Measure perceived volume on actual output devices when spatial audio matters. ## API reference Consult the [official documentation](https://threejs.org/docs/pages/PositionalAudio.html) for exact signatures and revision-specific behavior. If documentation access is unavailable, inspect installed types/source and state any remaining uncertainty.
© cesartevisual · MIT · cesartevisual/threejs-skills