Skip to content
cccskills
FreePublished on GitHub

video-chapters

Create timestamped chapter lists for medium-length and long videos. Transcribe speech with timing information, identify topic changes, and name each chapter, producing a text table of contents for YouTube or B站 descriptions plus structured JSON.

OriginalShow the original description

视频章节 / 时间戳目录:给中长视频自动生成章节划分和时间戳目录,用于 B站分P/YouTube 章节/视频描述区,方便观众跳转、提升完播。当用户说 视频章节、章节目录、时间戳、分章节、视频目录、chapters、B站章节、YouTube 章节、给视频加时间点、看点目录、视频大纲时间戳 时使用。

编排复用 asr.py(带时间轴转录),章节划分与命名由 LLM 完成。与 video-to-article 区别:那个把视频改写成成篇图文,本 SKILL 只出章节时间戳目录。

Works withYouTube

Run score Not tested

See how to install

Good for

  • Adding chapters to YouTube tutorials
  • Creating timestamp lists for B站 videos
  • Organizing lectures and livestream recordings by topic
  • Exporting chapter start times and titles as JSON

Files included (1)

  • SKILL.md3.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

视频章节 / 时间戳目录

给中长视频生成章节时间戳目录(B站/YouTube 描述区可用)。带时间轴转录走 asr.py, 章节切分与命名由你(LLM)完成。

出成篇图文见 video-to-article;出字幕见 auto-subtitle;切成短视频见 video-highlights。

输入

字段必填说明
视频文件是中长视频(教程/评测/讲座/直播回放;没给就问)
目标平台否B站 / YouTube / 通用(影响格式与措辞)
章节数否期望章节数(默认按内容自然划分,通常 5-12 段)

输出(outputs/主题名/)

  • chapters.txt — 时间戳目录(每行 mm:ss 章节名,可直接贴描述区)
  • chapters.json — 结构化(start 秒 + 标题),供程序化使用
  • transcript.txt — 转录原文(备查)

执行步骤

脚本路径(相对项目根):skills/shared/scripts/asr.py。

1. 带时间轴转录

python skills/shared/scripts/asr.py transcribe -i <视频> --format json \
  -o outputs/主题名/transcript.json

(首次跑 ASR 需外网代理下模型,见 auto-subtitle 前置说明。)

2. 划分章节(你来做)

读 transcript.json(每段带 start/end),按话题转折划分章节:

  • 找主题切换点作为章节边界(不是均匀切时间,而是按内容)。
  • 第一章从 00:00 开始(平台要求,否则章节功能不生效)。
  • 每章名 6-16 字,动词开头或点明看点(如"实测续航翻车了""3 分钟教你上手"),不写"第一部分"。
  • 章节数适中(太碎观众烦,太粗没用),一般 5-12 段;短视频(<3 分钟)通常不需要章节。
  • 章节最短 ≥10 秒(平台 YouTube 要求相邻章节间隔 ≥10s)。

3. 输出目录

写 chapters.txt(每行 mm:ss 章节名,首行必须 00:00):

00:00 开场|今天聊什么
01:24 第一个坑:xxx
03:50 实测环节
...

同时写 chapters.json:[{"start": 0, "title": "开场|今天聊什么"}, ...]。

平台格式差异

  • YouTube:贴在视频描述区,首个必须 0:00,≥3 章、每章 ≥10s 自动生效。
  • B站:作为"看点/进度条章节"或分P说明,格式 mm:ss 标题。
  • 通用:chapters.txt 通用可读。

规则

  1. 章节边界按话题转折定,不是均匀切时间。
  2. 首章必须 00:00;相邻章节间隔 ≥10s。
  3. 章节名点明看点、简洁有吸引力,不用"第一部分"这类空名。
  4. 不编造视频没讲的内容;依据转录如实划分。
  5. 产物统一进 outputs/主题名/。

参考来源

章节时间戳是 YouTube/B站 提升完播与检索的标准做法(首章 0:00、≥10s 间隔为平台硬规则)。 转录用 faster-whisper(asr.py)出时间轴,话题切分交给 LLM——确定性 IO 与语义划分分层。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ai-image-gen

FreeSummary

Generate images from written descriptions, transform existing images with editing instructions, or create several variations. Choose image dimensions and quantity, then save the results using an OpenAI-compatible service or apimart with your own API key.

  • Generating an illustration from a written description
  • Changing an image's background using instructions
  • Creating several variations of an existing image
ZJU-REAL/Easel4KUpdated Oct 23, 2026

ai-music

FreeSummary

Generate background music for short videos, vlogs, and social posts from descriptions of mood, style, and instruments. Download MP3 audio, optionally include sung lyrics, and use shared scripts to trim tracks, adjust loudness, or add music to videos.

  • Generating background music for a vlog intro
  • Creating instrumental music to match a social post
  • Generating a sung track from supplied lyrics
ZJU-REAL/Easel4KUpdated Oct 23, 2026

ai-video-gen

FreeSummary

Create new videos from written scene descriptions or still images using external AI services. Set the aspect ratio and duration, animate a character image, and request generated audio when the selected model supports it.

  • Generate a short video from a scene description
  • Animate a still image
  • Create character motion from a starting image
ZJU-REAL/Easel4KUpdated Oct 23, 2026

asset-manager

FreeSummary

Organize generated images, videos, and text in outputs/ by date, platform, and type. Add tags, search filenames and content, produce asset lists and reports, and preview archive moves before applying them to make past work easier to reuse.

  • Organizing generated assets by date, platform, and type
  • Finding past content through keywords and tags
  • Listing assets for a specific account or platform
ZJU-REAL/Easel4KUpdated Oct 23, 2026

audio-denoise

FreeSummary

Reduce background noise in audio recordings or video soundtracks with three processing levels. Keep the original file, create a cleaned version, and receive a report of the settings used and file details before and after processing.

  • Reducing fan or air conditioner noise in recordings
  • Cleaning speech in podcasts and interviews
  • Reducing noise in a video's audio track
ZJU-REAL/Easel4KUpdated Oct 23, 2026

audio-editing

FreeSummary

Edit audio files by trimming sections, converting formats, matching loudness, or extracting sound from videos. You can also join recordings, add fades, and change playback speed while keeping the original pitch.

  • Trim a recording to the section you need
  • Convert audio formats and match loudness
  • Extract audio from a video
ZJU-REAL/Easel4KUpdated Oct 23, 2026

See all skills by ZJU-REAL

Report a problem with this skill