# bilibili-subtitle

Достаёт субтитры из видео Bilibili через BBDown и раскладывает их в Markdown, SRT и VTT. Пригодится, когда нужен текст ролика, а не сам ролик.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 установок · ★ 13
- Автор: HamsteRider-m
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/HamsteRider-m/bilibili-subtitle/tree/HEAD/SKILL.md
- Обновлён: 2026-06-09
- HTML: https://affpapa.org/nevibecode/skills/bilibili-subtitle

## Что делает

Скилл принимает ссылку на видео Bilibili, BV- или av-идентификатор, запускает BBDown в режиме только субтитров и загружает скачанный файл. Дальше из него собираются три формата: транскрипт в Markdown, SRT и VTT. Язык выбирается флагом `--language`, например `zh-Hans`.

Работает это через окружение `pixi`: команды вида `pixi run python -m bilibili_subtitle "URL" -o ./output`. Есть режим проверки перед запуском (`--check` и `--check-json`) и вывод JSON для родительских скиллов — в ответе приходят `exit_code`, `output.files`, `warnings` и `errors`.

Без BBDown ничего не выйдет: если его нет, скилл вернёт фатальную ошибку E001 и предложит прогнать `./install.sh`. Для части видео BBDown требует авторизации — тогда нужен `BBDown login`. Скачиваются только те субтитры, которые BBDown отдаёт, включая автоматические субтитры Bilibili; если их нет, останется попробовать другой язык или другое видео.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install HamsteRider-m/bilibili-subtitle bilibili-subtitle
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/HamsteRider-m/bilibili-subtitle
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a opencode
```

### Claude.ai

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

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

## Когда брать
- вытащить текст из видео Bilibili, у которого есть субтитры
- получить транскрипт в Markdown для заметок или статьи
- сделать SRT или VTT для дальнейшей работы с таймкодами
- выбрать конкретный язык субтитров при скачивании
- отдать результат родительскому скиллу в виде JSON

## Примеры запросов агенту
- Скачай субтитры из этого видео Bilibili и положи файлы в ./output
- Вытащи транскрипт ролика по BV-идентификатору, язык zh-Hans
- Сделай SRT и VTT из субтитров этой ссылки

## Похожие
- [remotion-render](https://affpapa.org/nevibecode/skills/remotion-render.md) — скилл · 3 установки
- [recipe-share-event-materials](https://affpapa.org/nevibecode/skills/recipe-share-event-materials.md) — скилл · 29700 установок
- [blogwatcher](https://affpapa.org/nevibecode/skills/blogwatcher.md) — скилл · 5400 установок
- [ego-browser](https://affpapa.org/nevibecode/skills/ego-browser.md) — скилл · 12200 установок
- [composio](https://affpapa.org/nevibecode/skills/composio.md) — скилл · 8100 установок
- [remote-browser](https://affpapa.org/nevibecode/skills/remote-browser.md) — скилл · 4700 установок

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