bilibili-subtitle — Claude Code skill: Bilibili subtitles to text
Pulls subtitles out of Bilibili videos with BBDown and renders them as Markdown, SRT and VTT. Useful when you want the words, not the video.
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a claude-codeWhat bilibili-subtitle does
The skill takes a Bilibili link, a BV ID or an av ID, runs BBDown in subtitle-only mode and loads the file it downloads. From there it produces three outputs: a Markdown transcript, an SRT file and a VTT file. Pick a language with --language, for instance zh-Hans.
Everything runs inside a pixi environment, so calls look like pixi run python -m bilibili_subtitle "URL" -o ./output. A preflight check is available through --check and --check-json, and --json-output returns a payload with exit_code, output.files, warnings and errors for parent skills.
BBDown has to be present, otherwise the run stops with fatal error E001 and points you at ./install.sh. Some videos need a logged-in session, which means running BBDown login first. Only subtitles that BBDown exposes can be extracted, Bilibili's automatic ones included; when a video has none, the remaining options are another language or another video.
What it helps with
- get the spoken text out of a Bilibili video that ships subtitles
- turn a video into a Markdown transcript for notes or an article
- produce SRT or VTT files with timecodes
- pick a specific subtitle language during extraction
- hand structured JSON results back to a parent skill
Example prompts for the agent
- Grab the subtitles from this Bilibili video and write the files to ./output
- Extract the transcript for this BV ID, language zh-Hans
- Render SRT and VTT from the subtitles of this link
How to install bilibili-subtitle
1Skills CLI (Vercel)
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a claude-code2Manually: put the files in place
~/.claude/skills/bilibili-subtitle/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bilibili-subtitle/
1Skills CLI (Vercel)
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a codex2Manually: put the files in place
.agents/skills/bilibili-subtitle/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a cursor2Manually: put the files in place
.cursor/skills/bilibili-subtitle/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install HamsteRider-m/bilibili-subtitle bilibili-subtitle2Manually: put the files in place
.github/skills/bilibili-subtitle/SKILL.md1Skills CLI (Vercel)
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a gemini-cli2Platform CLI
gemini skills install https://github.com/HamsteRider-m/bilibili-subtitleManually: put the files in place
.devin/skills/bilibili-subtitle/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bilibili-subtitle
How do I install bilibili-subtitle in Claude Code?
Run npx skills add HamsteRider-m/bilibili-subtitle --skill bilibili-subtitle -a claude-code. The skill file then lands at ~/.claude/skills/bilibili-subtitle/SKILL.md.
What does bilibili-subtitle do?
It runs BBDown in subtitle-only mode, reads the downloaded subtitle file and renders a Markdown transcript plus SRT and VTT. With --json-output it also reports file paths, warnings and errors.
What does the skill need to run?
A pixi environment, the BBDown tool and gh, which the installer uses to fetch BBDown nightly builds. Without BBDown the skill fails with E001 and asks you to run ./install.sh.
