# add-voice

Добавляет в приложение голосовой диалог Grok с передачей речи в обе стороны. Нужен при замене каскада STT-LLM-TTS или OpenAI Realtime.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 319 установок · ★ 14099
- Автор: cursor
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cursor/plugins/tree/HEAD/grok-voice/skills/add-voice/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/add-voice

## Что делает

Скилл подключает приложение к голосовому режиму Grok по WebSocket: захватывает звук микрофона, отправляет аудиофрагменты и сразу воспроизводит ответ. Он настраивает сессию, VAD на сервере, транскрипцию `grok-transcribe` и обработку прерывания ответа пользователем.

Для браузера и мобильного клиента скилл предлагает получать временный токен через сервер, а на сервере использовать `XAI_API_KEY`. Долгоживущий ключ нельзя помещать в клиентскую сборку: это повод проверить существующую схему авторизации до подключения голоса. Основной пример написан на TypeScript, для Python есть вариант с `websockets`.

Скилл также задаёт поведение интерфейса: кнопка с волной запускает голосовой режим, а иконка микрофона остаётся для диктовки. Для распознавания речи без озвучивания нужен `/add-dictation`; для чтения текстовых ответов вслух — `/add-read-aloud`. Логи и поиск ошибок запускаются через `/debug-voice`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-voice -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-voice -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-voice -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cursor/plugins add-voice
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-voice -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/cursor/plugins --path grok-voice/skills/add-voice
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-voice -a opencode
```

### Claude.ai

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

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

## Когда брать
- добавить двусторонний голосовой диалог Grok
- заменить каскад STT-LLM-TTS одним соединением
- убрать постоянный API-ключ из клиентского кода
- воспроизводить аудиоответы с прерыванием реплики
- разделить голосовой режим и диктовку в интерфейсе

## Примеры запросов агенту
- \`/add-voice` Добавь голосовой режим Grok в это приложение.
- Добавь голосовой диалог Grok и подключи микрофон приложения.
- \`/add-voice` Замени текущий каскад STT-LLM-TTS голосовой сессией Grok.

## Похожие
- [realtime](https://affpapa.org/nevibecode/skills/realtime.md) — скилл · 634 установки
- [bun-websocket-server](https://affpapa.org/nevibecode/skills/bun-websocket-server.md) — скилл · 394 установки
- [azure-messaging-webpubsubservice-py](https://affpapa.org/nevibecode/skills/azure-messaging-webpubsubservice-py.md) — скилл · 1 установка
- [twilio-voice-twiml](https://affpapa.org/nevibecode/skills/twilio-voice-twiml.md) — скилл · ★ 7596
- [neon-realtime](https://affpapa.org/nevibecode/skills/neon-realtime.md) — скилл · 6000 установок
- [speech-engine](https://affpapa.org/nevibecode/skills/speech-engine.md) — скилл · 6500 установок

Из того же набора: [cursor/plugins](https://affpapa.org/nevibecode/by/cursor/plugins.md) — 45 карточек

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