home / skills / nanmicoder / claude-code-skills / bilibili-chapter-generator

bilibili-chapter-generator skill

safe

/plugins/bilibili-chapter-generator/skills/bilibili-chapter-generator

This skill generates Bilibili chapters from subtitles, ensuring correct timing, titles, and formatting for easy copying into the editor.

npx playbooks add skill nanmicoder/claude-code-skills --skill bilibili-chapter-generator

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

3.5 KB

---
name: bilibili-chapter-generator
description: |
  为 B站视频生成章节列表。
  触发场景：
  (1) 需要为视频创建 B站章节
  (2) 用户说"转成B站格式"、"生成章节"、"生成B站章节"
  (3) 需要从字幕生成视频分段
  (4) 处理视频进度条分段标记
metadata:
  author: nanmi
  version: "1.0.0"
---

# B站视频章节生成器

根据字幕内容为 B站视频生成章节列表，用户可直接复制到 B站视频编辑页面。

## B站章节格式规范

```
00:00 引言
01:23 第一部分标题
05:30 第二部分标题
```

**格式要求（B站硬性限制）：**
- **第一个章节必须从 `00:00` 开始**（这是强制要求）
- **章节数量：3-10 个**（必须 > 2 且 ≤ 10）
- **章节标题不能包含特殊符号**（禁止使用 `：` `:` `、` `，` `。` `！` `？` `【】` `()` 等）
- 时间格式：`MM:SS`（分:秒）或 `HH:MM:SS`（时:分:秒）
- 每行一个章节：`时间戳 章节标题`
- 章节间隔必须 ≥ 5 秒

## 工作流程

### Step 1: 获取 SRT 文件

询问用户 SRT 字幕文件路径，或从上下文中获取。

### Step 2: 解析字幕内容

调用 `srt-to-structured-data` skill 解析字幕：

```bash
python3 ~/.claude/skills/srt-to-structured-data/scripts/parse_srt.py "<srt_file_path>" --stats
```

这会输出：
- 字幕的 JSON 结构（包含时间码和文本）
- 统计信息（总时长、字幕数量等）

### Step 3: 分析字幕内容

阅读字幕内容，理解视频的：
- 主题和结构
- 内容转折点
- 关键话题变化

### Step 4: 生成章节列表

根据用户的描述意图（如果有）或自动分析，生成章节列表：

1. **识别内容转折点**：找出话题变化、新段落开始的位置
2. **确定章节标题**：简洁描述该段内容（建议 2-8 个字）
3. **校验时间间隔**：确保相邻章节间隔 ≥ 5 秒
4. **格式化输出**：使用 `MM:SS 标题` 格式

### Step 5: 输出结果

输出纯文本格式的章节列表，用户可直接复制：

```
00:00 开场介绍
02:15 核心概念讲解
08:30 实战演示
15:00 总结回顾
```

## 使用示例

**用户输入：**
```
帮我把 ./视频字幕.srt 转成B站章节
```

**或更详细的需求：**
```
帮我生成B站章节，要求：
- 字幕文件：./demo.srt
- 大概分成 5-6 个章节
- 重点突出实战部分
```

## 章节划分建议

**B站限制：3-10 个章节（必须 > 2 且 ≤ 10）**

- **短视频（< 5 分钟）**：3-4 个章节
- **中等视频（5-15 分钟）**：4-7 个章节
- **长视频（> 15 分钟）**：7-10 个章节

## 注意事项

1. **第一个章节必须是 `00:00`**，命名为"开场"、"引言"或直接点题
2. **章节标题禁止特殊符号**：不能使用冒号、顿号、逗号、括号等，只用纯中文/英文/数字
3. 章节标题要简洁有力，便于观众快速定位（建议 2-8 个字，纯文字）
4. 最后一个章节可以是"总结"、"结语"或"彩蛋"
5. 避免章节过于密集（间隔太短会显得杂乱）
6. 时间戳取字幕段落开始时间，向下取整到秒
7. **章节总数必须 > 2 且 ≤ 10**，否则B站会拒绝

## 章节标题示例

**正确示例：**
- `00:00 开场介绍`
- `03:35 Agent演示加载skill流程`
- `05:39 环境配置`
- `08:38 源码解析`

**错误示例（包含特殊符号）：**
- ~~`03:35 Agent演示：加载skill的流程`~~ （包含冒号）
- ~~`05:39 环境准备、安装依赖`~~ （包含顿号）
- ~~`08:38 代码解析（核心逻辑）`~~ （包含括号）

Overview

This skill generates Bilibili-compatible chapter lists from video subtitles so users can copy them directly into the Bilibili video editor. It enforces Bilibili formatting rules and produces 3–10 clean, timestamped chapter lines. The output is ready-to-paste plain text in MM:SS or HH:MM:SS timestamp format.

How this skill works

The skill reads an SRT subtitle file (path provided by the user) and parses it into structured timecode and text. It analyzes subtitle content to detect topic shifts and key segment starts, selects representative short titles, verifies minimum spacing between chapters, and formats the results to meet Bilibili constraints. You receive a plain text list that begins at 00:00 and contains between 3 and 10 chapters.

When to use it

You have an SRT subtitle file and need Bilibili chapter timestamps quickly.
You want chapters that reflect topic changes or key moments from subtitles.
You need Bilibili-compliant output that enforces timestamp and title rules.
You want to split a long talk into 3–10 digestible sections for viewers.
You need to convert progress-bar marks or subtitle segments into chapters.

Best practices

Provide the SRT file path or attach the subtitle so parsing can start immediately.
Specify desired chapter count (3–10) or let the skill choose based on content.
Request emphasis (e.g., highlight practical demo or conclusion) to bias titles.
Keep chapter title length to 2–8 characters and avoid punctuation/special symbols.
Verify final timestamps—titles use the start time of subtitle segments rounded down to seconds.

Example use cases

Convert ./video.srt into 5 Bilibili chapters emphasizing the demo section.
Auto-generate 7 chapters for a 20-minute tutorial to improve viewer navigation.
Turn progress-bar segment markers into a Bilibili-ready chapter list.
Produce concise titles for a lecture video so viewers can jump to key topics.

FAQ

What format will the timestamps use?

Timestamps are formatted as MM:SS or HH:MM:SS depending on total duration and always start with 00:00 for the first chapter.

Can I control the number of chapters?

Yes. You can request a specific count between 3 and 10; otherwise the skill auto-selects based on content structure.

Are special characters allowed in titles?

No. Chapter titles must not contain punctuation or special symbols; use plain Chinese, English, or numbers only.