subtitles · openai — скилл для Codex: что делает и как установить
Вшивает субтитры в готовое видео с синхронизацией речи через Whisper. Подходит для автоматического оформления роликов без ручной разметки таймкодов.
npx skills add openai/plugins --skill subtitles -a codexЧто делает subtitles
Скилл принимает готовый видеофайл и накладывает жёсткие субтитры прямо в кадр. Синхронизация фраз вычисляется исключительно по аудиодорожке через локальный faster-whisper или OpenAI STT: тайминги из сценария не угадываются. Если к задаче приложен готовый текст диктора, скилл сохраняет авторские названия и термины, используя распознавание только для привязки слов ко времени.
Для оформления доступно три стиля: базовый clean на базе ffmpeg и libass без тяжёлых библиотек, рваная бумажная плашка paper и контрастный bold с учётом безопасных зон соцсетей. По умолчанию действуют ограничения: не более трёх слов или пятнадцати знаков на одну строчку. Без установленного faster-whisper или переменной OPENAI_API_KEY субтитры не соберутся, и скилл вернёт исходное видео без изменений.
Какие задачи решает
- наложить субтитры прямо на видеоряд с точной разбивкой по словам
- заменить распознанный текст оригинальным сценарием без потери таймингов
- оформить короткие реплики в стиле соцсетей без перекрытия ключевых зон
- вшить субтитры через ffmpeg без установки Pillow в минимальном окружении
Примеры запросов агенту
- Добавь субтитры к ролику
cut.mp4в стиле clean. - Синхронизируй текст из
script_manifest.jsonи вшей субтитры вvideo.mp4со стилем bold. - Сделай субтитры в стиле paper для готового видео
final.mp4.
Как установить subtitles
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill subtitles -a codex2Вручную: положить файлы
.agents/skills/subtitles/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill subtitles -a claude-code2Вручную: положить файлы
~/.claude/skills/subtitles/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/subtitles/
Вручную: положить файлы
.cursor/skills/subtitles/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins subtitles2Вручную: положить файлы
.github/skills/subtitles/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/higgsfield/skills/subtitlesВручную: положить файлы
.devin/skills/subtitles/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о subtitles
Как установить subtitles в Codex?
Выполните команду npx skills add openai/plugins --skill subtitles в консоли проекта.
Откуда берутся таймкоды для реплик?
Скилл рассчитывает время строго по звуковой дорожке с помощью Whisper. Оценка длительности фраз по длине текста сценария запрещена правилами пайплайна.
Поддерживает ли стиль paper кириллический текст?
Шрифт PatrickHand, выбранный для paper по умолчанию, не содержит кириллицы. Для русских субтитров нужно явно передать подходящий шрифт, например Montserrat-ExtraBold или Caveat.
Похожие скиллы
Все скиллы по теме «ИИ и ML» →Сначала — subtitles от других авторов.