@hamsterider-m/bilibili-subtitle

从 Bilibili 视频提取字幕、转录无字幕视频、生成结构化摘要。触发条件:Bilibili URL (bilibili.com)、BV ID (BV1xxx)、或"提取B站字幕"等请求。

View in AI SkillSafe app
24 downloads
0 stars
0 demos
SKILL.md

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

Embed badges

Add these to your README to show the skill's verification status.

SkillSafe verified badge
Verified badge
[![SkillSafe verified badge](https://api.skillsafe.ai/v1/badge/@hamsterider-m/bilibili-subtitle/verified)](https://skillsafe.ai/skill/@hamsterider-m/bilibili-subtitle/)
Installs badge
Installs badge
[![Installs badge](https://api.skillsafe.ai/v1/badge/@hamsterider-m/bilibili-subtitle/installs)](https://skillsafe.ai/skill/@hamsterider-m/bilibili-subtitle/)
Scan badge
Scan badge
[![Scan badge](https://api.skillsafe.ai/v1/badge/@hamsterider-m/bilibili-subtitle/scan)](https://skillsafe.ai/skill/@hamsterider-m/bilibili-subtitle/)
Eval pass rate badge
Eval pass rate
[![Eval pass rate badge](https://api.skillsafe.ai/v1/badge/@hamsterider-m/bilibili-subtitle/eval)](https://skillsafe.ai/skill/@hamsterider-m/bilibili-subtitle/)