transcribe — скилл для Claude Code: что делает и как установить
Переводит аудиозаписи в текст и размечает реплики говорящих через модели OpenAI. Пригодится при обработке записей митингов, интервью и голосовых заметок.
npx claude-code-templates@latest --skill media/transcribeЧто делает transcribe
Скилл автоматизирует распознавание речи из звуковых дорожек с помощью скрипта transcribe_diarize.py. Базовый режим задействует модель gpt-4o-mini-transcribe и сразу возвращает обычный текст. Если требуется разделить реплики собеседников, скрипт переключается на gpt-4o-transcribe-diarize с выдачей структурированного JSON.
Для точной разметки диалогов можно передавать звуковые фрагменты голосов конкретных спикеров (поддерживается до четырёх человек). При этом текстовые подсказки в режиме диаризации не поддерживаются, поэтому скорректировать контекст промптом не получится. Аудиофайлы длиннее тридцати секунд утилита автоматически делит на части перед отправкой.
Для запуска понадобятся Python с установленным пакетом openai и заданная переменная окружения OPENAI_API_KEY. Без экспортированного в терминале ключа скрипт откажется выполнять запросы к API. Результаты обработки сохраняются в каталог output/transcribe/ или в путь, указанный во флаге --out.
Какие задачи решает
- преобразовать аудиодорожку встречи в текстовый формат
- разделить реплики разных спикеров в записи интервью
- сопоставить голоса участников с образцами аудио
- сохранить структурированную расшифровку в JSON-файл
Примеры запросов агенту
- Расшифруй аудиофайл
interview.mp3и сохрани обычный текст вinterview.txt - Сделай диаризацию записи
meeting.m4a, сопоставив участников сrefs/alice.wavиrefs/bob.wav - Переведи голосовую заметку
voice.wavв текст с помощью моделиgpt-4o-mini-transcribe
Как установить transcribe
1Через claude-code-templates
npx claude-code-templates@latest --skill media/transcribe2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill transcribe -a claude-code3Вручную: положить файлы
~/.claude/skills/transcribe/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/transcribe/
Вручную: положить файлы
.agents/skills/transcribe/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/transcribe/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates transcribe2Вручную: положить файлы
.github/skills/transcribe/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/media/transcribeВручную: положить файлы
.devin/skills/transcribe/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о transcribe
Как установить transcribe в Claude Code?
Выполните команду npx claude-code-templates@latest --skill media/transcribe. Скилл сразу станет доступен агенту.
Что делает скилл transcribe?
Он запускает встроенный скрипт для передачи аудио в OpenAI, формируя текстовый файл или JSON с распределением по спикерам.
Какие зависимости нужны для запуска?
Требуется интерпретатор Python 3 с пакетом openai (устанавливается через uv pip install openai или python3 -m pip install openai) и рабочий OPENAI_API_KEY в окружении.