# subtitles

Загружает субтитры и расшифровки с YouTube по ссылке или идентификатору ролика. Помогает переводить видео, читать текст речи и изучать языки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 810 установок · ★ 1121
- Автор: ZeroPointRepo
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ZeroPointRepo/youtube-skills/tree/HEAD/clawhub/subtitles/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/zeropointrepo-subtitles

## Что делает

Скилл отправляет запрос к сервису TranscriptAPI и возвращает текст речи из любого видео на YouTube. Для вызова нужен URL или идентификатор ролика. Текст можно запросить как сплошным полотном для быстрого чтения, так и в формате JSON с таймкодами для синхронного перевода.

Для работы требуется ключ в переменной окружения `TRANSCRIPT_API_KEY` и доступ в интернет. Запрос обязательно должен содержать заголовок `User-Agent` с именем агента, потому что без него Cloudflare блокирует обращение с ошибкой 403.

Инструмент рассчитан только на чтение субтитров и метаданных вроде названия и описания ролика. Загружать новые субтитры в YouTube или управлять аккаунтом через него нельзя.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZeroPointRepo/youtube-skills --skill subtitles -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZeroPointRepo/youtube-skills --skill subtitles -a codex
```

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ZeroPointRepo/youtube-skills subtitles
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZeroPointRepo/youtube-skills --skill subtitles -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ZeroPointRepo/youtube-skills --path clawhub/subtitles
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ZeroPointRepo/youtube-skills --skill subtitles -a opencode
```

### Claude.ai

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

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

## Когда брать
- получить расшифровку YouTube-видео по ссылке или ID
- извлечь текст ролика с таймкодами для перевода
- забрать чистый текст речи для чтения и конспектов
- скачать метаданные видео вместе с субтитрами

## Примеры запросов агенту
- Достань расшифровку из видео с идентификатором dQw4w9WgXcQ
- Сделай чистый текст без таймкодов для ролика dQw4w9WgXcQ
- Скачай субтитры с таймкодами для перевода видео dQw4w9WgXcQ

## Похожие
- [video-transcript-downloader](https://affpapa.org/nevibecode/skills/video-transcript-downloader.md) — скилл · 1000 установок
- [youtube-transcript](https://affpapa.org/nevibecode/skills/badlogic-youtube-transcript.md) — скилл · 714 установок
- [remotion-captions](https://affpapa.org/nevibecode/skills/remotion-dev-remotion-captions.md) — скилл · 211800 установок
- [youtube-full](https://affpapa.org/nevibecode/skills/youtube-full.md) — скилл · 78 установок
- [caption-animation](https://affpapa.org/nevibecode/skills/caption-animation.md) — скилл · 2000 установок
- [scenario-caption-studio](https://affpapa.org/nevibecode/skills/scenario-caption-studio.md) — скилл · 369 установок

Из того же набора: [zeropointrepo/youtube-skills](https://affpapa.org/nevibecode/by/zeropointrepo/youtube-skills.md) — 10 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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