add-voice — скилл для Claude Code: голосовой режим Grok
Добавляет в приложение голосовой диалог Grok с передачей речи в обе стороны. Нужен при замене каскада STT-LLM-TTS или OpenAI Realtime.
npx skills add cursor/plugins --skill add-voice -a claude-codeЧто делает add-voice
Скилл подключает приложение к голосовому режиму Grok по WebSocket: захватывает звук микрофона, отправляет аудиофрагменты и сразу воспроизводит ответ. Он настраивает сессию, VAD на сервере, транскрипцию grok-transcribe и обработку прерывания ответа пользователем.
Для браузера и мобильного клиента скилл предлагает получать временный токен через сервер, а на сервере использовать XAI_API_KEY. Долгоживущий ключ нельзя помещать в клиентскую сборку: это повод проверить существующую схему авторизации до подключения голоса. Основной пример написан на TypeScript, для Python есть вариант с websockets.
Скилл также задаёт поведение интерфейса: кнопка с волной запускает голосовой режим, а иконка микрофона остаётся для диктовки. Для распознавания речи без озвучивания нужен /add-dictation; для чтения текстовых ответов вслух — /add-read-aloud. Логи и поиск ошибок запускаются через /debug-voice.
Какие задачи решает
- добавить двусторонний голосовой диалог Grok
- заменить каскад STT-LLM-TTS одним соединением
- убрать постоянный API-ключ из клиентского кода
- воспроизводить аудиоответы с прерыванием реплики
- разделить голосовой режим и диктовку в интерфейсе
Примеры запросов агенту
/add-voiceДобавь голосовой режим Grok в это приложение.- Добавь голосовой диалог Grok и подключи микрофон приложения.
/add-voiceЗамени текущий каскад STT-LLM-TTS голосовой сессией Grok.
Как установить add-voice
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-voice -a claude-code2Вручную: положить файлы
~/.claude/skills/add-voice/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/add-voice/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-voice -a codex2Вручную: положить файлы
.agents/skills/add-voice/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-voice -a cursor2Вручную: положить файлы
.cursor/skills/add-voice/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cursor/plugins add-voice2Вручную: положить файлы
.github/skills/add-voice/SKILL.md1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-voice -a gemini-cli2Командой платформы
gemini skills install https://github.com/cursor/plugins --path grok-voice/skills/add-voiceВручную: положить файлы
.devin/skills/add-voice/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-voice -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о add-voice
Как установить add-voice в Claude Code?
Выполните npx skills add cursor/plugins --skill add-voice -a claude-code, затем повторите npx skills add cursor/plugins --skill add-voice -a claude-code. Файл скилла находится в ~/.claude/skills/add-voice/SKILL.md.
Что делает add-voice?
Скилл добавляет в существующее приложение голосовую сессию Grok с приёмом аудио с микрофона и воспроизведением ответа. Он покрывает авторизацию, обработку событий сессии и правила интерфейса голосового режима.
Что требуется для безопасной авторизации в браузере?
Браузерный или мобильный клиент должен получать временный токен через сервер. XAI_API_KEY используется на серверной стороне и не должен попадать в клиентскую сборку.
