Bilibili Subtitle Skill

Extract Bilibili subtitles with BBDown and render transcript outputs.

When To Use

Use this skill when a Bilibili video already has downloadable subtitles, including Bilibili AI subtitles exposed by BBDown. This skill only extracts subtitle files exposed by BBDown.

Commands

Task	Command
Preflight	pixi run python -m bilibili_subtitle --check
JSON preflight	pixi run python -m bilibili_subtitle --check-json
Extract	pixi run python -m bilibili_subtitle "URL" -o ./output
Extract JSON	pixi run python -m bilibili_subtitle "URL" -o ./output --json-output
Select language	pixi run python -m bilibili_subtitle "URL" --language zh-Hans -o ./output

Workflow

1. Parse the Bilibili URL, BV ID, or av ID.
2. Run BBDown in subtitle-only mode.
3. Load the downloaded subtitle file.
4. Render Markdown transcript, SRT, and VTT files.
5. Optionally emit JSON for parent skills.

Outputs

output/
├── {title}.transcript.md
├── {title}.srt
└── {title}.vtt

JSON Contract

pixi run python -m bilibili_subtitle "URL"   -o /tmp/output   --json-output

The response includes exit_code, output.files, warnings, and errors.

Dependencies

• pixi for the Python environment
• BBDown for subtitle extraction
• gh for installer-driven BBDown nightly downloads

Error Handling

Code	Level	Meaning	Remediation
E001	FATAL	BBDown missing	Run ./install.sh
E002	FATAL	BBDown auth required	Run BBDown login
E003	RECOVERABLE	Download failed	Check URL/network/login/language
E004	RECOVERABLE	No downloadable subtitles	Try another language or video
E005	FATAL	Invalid URL/ID	Provide a Bilibili URL, BV ID, or av ID
E006	FATAL	Output write failed	Check output directory permissions
E007	RECOVERABLE	Invalid subtitle content	Retry or inspect BBDown output