add-dictation — скилл для Claude Code: диктовка через Grok STT
Скилл добавляет в ваше приложение распознавание речи Grok: кнопку микрофона, живые субтитры или расшифровку записанных файлов.
npx skills add cursor/plugins --skill add-dictation -a claude-codeЧто делает add-dictation
Скилл включается на /add-dictation, по слову «Dictate» или когда вы просите что-то расшифровать. Он разбирает ваш проект: находит поле ввода, куда должен попасть текст, серверный фреймворк и менеджер пакетов, а потом пишет код под них.
Есть два пути. Пакетный режим — один запрос POST https://api.x.ai/v1/stt: клиент записывает звук через MediaRecorder, отправляет его на ваш серверный маршрут, а тот пересылает файл в multipart/form-data. Потоковый режим идёт через wss://api.x.ai/v1/stt и нужен, когда текст должен появляться прямо во время речи. Браузер не умеет ставить заголовки в WebSocket, поэтому ключ держит серверный релей.
Ключ XAI_API_KEY живёт только на сервере. В клиентскую сборку его класть нельзя, и в чат его тоже не вставляйте. Модель скилл советует брать из раздела model-selection в документации xAI, а не из примеров в самом скилле. У Cursor микрофона нет, так что подключается ваше приложение, а не редактор.
Какие задачи решает
- добавить кнопку микрофона в поле ввода
- показать текст на экране, пока человек говорит
- расшифровать загруженный аудиофайл или ссылку
- собрать субтитры с таймкодами по словам
- разделить запись встречи по говорящим
Примеры запросов агенту
- Добавь диктовку в композер нашего приложения через Claude STT
- Сделай живые субтитры во время записи с микрофона
- Расшифруй этот файл и верни текст с таймкодами
Как установить add-dictation
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-dictation -a claude-code2Вручную: положить файлы
~/.claude/skills/add-dictation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/add-dictation/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-dictation -a codex2Вручную: положить файлы
.agents/skills/add-dictation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-dictation -a cursor2Вручную: положить файлы
.cursor/skills/add-dictation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cursor/plugins add-dictation2Вручную: положить файлы
.github/skills/add-dictation/SKILL.md1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-dictation -a gemini-cli2Командой платформы
gemini skills install https://github.com/cursor/plugins --path grok-voice/skills/add-dictationВручную: положить файлы
.devin/skills/add-dictation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill add-dictation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о add-dictation
Как установить add-dictation в Claude Code?
Выполните npx skills add cursor/plugins --skill add-dictation -a claude-code. Скилл окажется в ~/.claude/skills/add-dictation/SKILL.md.
Что делает add-dictation?
Добавляет в ваше приложение распознавание речи Claude: кнопку диктовки, живые субтитры или расшифровку записанных файлов и ссылок.
Нужен ли ключ API для работы скилла?
Да, XAI_API_KEY. Он должен оставаться на сервере: браузер не может отправить его в WebSocket-заголовке, поэтому потоковый режим идёт через ваш релей.
