assemblyai — скилл для Claude Code: транскрипция и голосовые агенты
Скилл для работы с AssemblyAI: распознавание речи, стриминг, диктовка и LLM Gateway. Спасает от устаревших примеров, которые ИИ берёт из обучающих данных.
npx skills add AssemblyAI/assemblyai-skill --skill assemblyai -a claude-codeЧто делает assemblyai
Скилл описывает, как правильно обращаться к API AssemblyAI: асинхронная транскрипция, синхронное распознавание до 120 секунд, диктовка с переписыванием текста, стриминг v3 и Voice Agent API. Отдельно разобраны зоны данных — европейская и американская, чтобы аудио и расшифровки не уезжали за нужный периметр.
Главная ценность в том, что скилл чинит типовые ошибки. Авторизация здесь идёт заголовком Authorization: YOUR_API_KEY без префикса Bearer — на этом спотыкаются чаще всего. Ещё он напоминает, что Java, Go и C# SDK закрыты в апреле 2025, и для этих языков остаётся только REST API. Живые SDK — Python, JavaScript/TypeScript и Ruby.
Для Python есть ломающие изменения в версии 1.0.0: aai.Lemur и все имена Lemur* удалены, опция assemblyai[extras] больше не ставится, а MicrophoneStream из SDK убран — захват микрофона придётся делать через pyaudio или sounddevice. В Node 4.37.0 так же вырезан client.lemur. Если проект уже стоит на старых версиях, это повод проверить зависимости перед обновлением.
Какие задачи решает
- расшифровать аудио или видео в текст через асинхронный API
- поднять потоковое распознавание речи в реальном времени
- превратить надиктованные заметки в чистый текст
- разделить запись по спикерам и вырезать персональные данные
- собрать голосового агента на LiveKit или Pipecat с распознаванием речи
Примеры запросов агенту
- Подключи AssemblyAI и сделай транскрипцию файла
meeting.mp3с разделением по спикерам - Настрой стриминговое распознавание через AssemblyAI для голосового агента
- Проверь, какая версия SDK AssemblyAI стоит в проекте, и обнови её до актуальной
Как установить assemblyai
1Через Skills CLI (Vercel)
npx skills add AssemblyAI/assemblyai-skill --skill assemblyai -a claude-code2Вручную: положить файлы
~/.claude/skills/assemblyai/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/assemblyai/
1Через Skills CLI (Vercel)
npx skills add AssemblyAI/assemblyai-skill --skill assemblyai -a codex2Вручную: положить файлы
.agents/skills/assemblyai/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AssemblyAI/assemblyai-skill --skill assemblyai -a cursor2Вручную: положить файлы
.cursor/skills/assemblyai/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AssemblyAI/assemblyai-skill assemblyai2Вручную: положить файлы
.github/skills/assemblyai/SKILL.md1Через Skills CLI (Vercel)
npx skills add AssemblyAI/assemblyai-skill --skill assemblyai -a gemini-cli2Командой платформы
gemini skills install https://github.com/AssemblyAI/assemblyai-skill --path skills/assemblyaiВручную: положить файлы
.devin/skills/assemblyai/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AssemblyAI/assemblyai-skill --skill assemblyai -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о assemblyai
Как установить assemblyai в Claude?
Выполните npx skills add AssemblyAI/assemblyai-skill --skill assemblyai -a claude-code. Скилл появится в ~/.claude/skills/assemblyai/SKILL.md.
Что делает скилл assemblyai?
Он даёт агенту точные сведения об API и SDK AssemblyAI: авторизацию, базовые URL, актуальные модели распознавания и ломающие изменения в версиях. Без него ИИ часто пишет код по устаревшим примерам.
Какие SDK AssemblyAI ещё поддерживаются?
Живые SDK — Python, JavaScript/TypeScript и Ruby. Java, Go и C# закрыты в апреле 2025, для них нужно обращаться к REST API напрямую.
