Agent skill

Video Chapters

by ZJU-REAL in ZJU-REAL/Easel

视频章节 / 时间戳目录:给中长视频自动生成章节划分和时间戳目录,用于 B站分P/YouTube 章节/视频描述区,方便观众跳转、提升完播。当用户说 视频章节、章节目录、时间戳、分章节、视频目录、chapters、B站章节、YouTube 章节、给视频加时间点、看点目录、视频大纲时间戳 时使用。编排复用 asr.py(带时间轴转录),章节划分与命名由 LLM 完成。与…

Apache-2.0Auto-check passedAI & LLM Engineering

Install Video Chapters

skills CLI
$ npx skills add ZJU-REAL/Easel --skill video-chapters -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZJU-REAL/Easel video-chapters --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/video-chapters .claude/skills/video-chapters && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
video-chapters
GitHub stars
3.4k
Token cost
~470 tokens
SKILL.md length
118 words
Files
1
Skills in repo
114
Repo updated
First seen
Licence
Apache-2.0

At a glance

视频章节 / 时间戳目录:给中长视频自动生成章节划分和时间戳目录,用于 B站分P/YouTube 章节/视频描述区,方便观众跳转、提升完播。当用户说 视频章节、章节目录、时间戳、分章节、视频目录、chapters、B站章节、YouTube 章节、给视频加时间点、看点目录、视频大纲时间戳 时使用。编排复用 asr.py(带时间轴转录),章节划分与命名由 LLM 完成。与…

  • Works in 3 steps: 带时间轴转录 → 划分章节(你来做) → 输出目录
  • Tasks that involve Speech recognition and synthesis
  • SKILL.md covers 输入, 输出(outputs/主题名/), 执行步骤 and 平台格式差异, plus 2 more sections
  • Calls python

What it does

Video Chapters is an agent skill from ZJU-REAL/Easel. 视频章节 / 时间戳目录:给中长视频自动生成章节划分和时间戳目录,用于 B站分P/YouTube 章节/视频描述区,方便观众跳转、提升完播。当用户说 视频章节、章节目录、时间戳、分章节、视频目录、chapters、B站章节、YouTube 章节、给视频加时间点、看点目录、视频大纲时间戳 时使用。编排复用 asr.py(带时间轴转录),章节划分与命名由 LLM 完成。与 video-to-article 区别:那个把视频改写成成篇图文,本 SKILL 只出章节时间戳目录。

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Speech recognition and synthesis. It works with YouTube. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Speech recognition and synthesis

Example prompts

  • “/video-chapters”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. 带时间轴转录
  2. 划分章节(你来做)
  3. 输出目录

What it can do on your machine

Read from SKILL.md and the folder at commit 278f420. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Video Chapters loads about 470 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 118 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~470

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZJU-REAL/Easel at commit 278f420, republished under its Apache-2.0 licence (© ZJU-REAL). 118 words, ~470 tokens.

Download SKILL.mdSave it as .claude/skills/video-chapters/SKILL.md (or your agent's skills folder).
name
video-chapters
description
视频章节 / 时间戳目录:给中长视频自动生成章节划分和时间戳目录,用于 B站分P/YouTube 章节/视频描述区,方便观众跳转、提升完播。当用户说 视频章节、章节目录、时间戳、分章节、视频目录、chapters、B站章节、YouTube 章节、给视频加时间点、看点目录、视频大纲时间戳 时使用。编排复用 asr.py(带时间轴转录),章节划分与命名由 LLM 完成。与 video-to-article 区别:那个把视频改写成成篇图文,本 SKILL 只出章节时间戳目录。
layer
produce

视频章节 / 时间戳目录

给中长视频生成章节时间戳目录(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. 带时间轴转录
bash
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 与语义划分分层。

© ZJU-REAL, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/openclaw/video-chapters of ZJU-REAL/Easel.

Open the folder on GitHubat commit 278f420

Compare with similar skills

Video Chapters next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Video Chapters compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Video Chapters this skillZJU-REAL/Easel3.4k—~470Automated safety check: PassApache-2.0
Youtube FetcherJimmySadek/youtube-fetcher-to-markdown485—~3.1kAutomated safety check: PassMIT
Shorts Video Makeruxjoseph/content-marketing-team107—~665Automated safety check: PassNone
Watchmathiaschu/watch142—~4kAutomated safety check: WarnMIT
Watch Videocoreyhaines31/makerskills851—~3.8kAutomated safety check: PassMIT
TriageTalAter/annyang6.8k—~810Automated safety check: NotesMIT

Similar skills

  • Youtube Fetcher

    JimmySadek/youtube-fetcher-to-markdown

    Retrieve transcripts from YouTube, Instagram, TikTok, X, Vimeo and other video sites, summarize or analyze what was said (and shown on screen), or save an Obsidian-ready Markdown knowledge-base note…

    485 GitHub stars~3.1k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Shorts Video Maker

    uxjoseph/content-marketing-team

    YouTube 영상에서 쇼츠 클립 3개를 자동 제작합니다. An agent skill from uxjoseph/content-marketing-team.

    107 GitHub stars~665 tokensUpdated 9 mo ago
    Media & CreativeAuto-check passed
  • Watch

    mathiaschu/watch

    Watch a video from YouTube, Instagram, X/Twitter, Vimeo, TikTok or any of ~1800 yt-dlp sites (or a local path).

    142 GitHub stars~4k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: warnings
  • Watch Video

    coreyhaines31/makerskills

    When you want to extract content from a video — YouTube, Loom, Vimeo, Riverside, Zoom recording, local MP4, X/IG video, anything yt-dlp supports.

    851 GitHub stars~3.8k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Triage

    TalAter/annyang

    Triage and close GitHub issues on TalAter/annyang. An agent skill from TalAter/annyang.

    6.8k GitHub stars~810 tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check: notes
  • Yichen Asr

    mcncarl/yichen-skills

    逸尘自用的统一音视频转写入口,在 StepFun Step ASR 与火山引擎豆包 ASR 之间按输出需求、安全边界和可用状态路由。用于本地音频或视频的纯文本转写、时间戳、SRT 字幕、口播粗剪,以及转写前体检;用户明确指定服务商时不得静默切换。Use when a local audio or video file needs transcription and the correct…

    4.4k GitHub stars~780 tokensUpdated 6 days ago
    AI & LLM EngineeringAuto-check passed

More from ZJU-REAL/Easel

All 114 skills in this repo
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.4k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Ecom Details Image

    ZJU-REAL/Easel

    生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.4k GitHub stars~643 tokensUpdated today
    Auto-check passed
  • Novel Writer

    ZJU-REAL/Easel

    长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Questions about Video Chapters

What does Video Chapters do?

视频章节 / 时间戳目录:给中长视频自动生成章节划分和时间戳目录,用于 B站分P/YouTube 章节/视频描述区,方便观众跳转、提升完播。当用户说 视频章节、章节目录、时间戳、分章节、视频目录、chapters、B站章节、YouTube 章节、给视频加时间点、看点目录、视频大纲时间戳 时使用。编排复用 asr.py(带时间轴转录),章节划分与命名由 LLM 完成。与…. Video Chapters is an agent skill from ZJU-REAL/Easel.

When should I use Video Chapters?

Video Chapters fits situations like: tasks that involve Speech recognition and synthesis.

How do I install Video Chapters in Claude Code?

Run `npx skills add ZJU-REAL/Easel --skill video-chapters -a claude-code`. Or copy the skill folder (skills/openclaw/video-chapters in ZJU-REAL/Easel) into .claude/skills/video-chapters in your project. Claude Code loads it when a task matches its description.

How do I install Video Chapters in Codex?

Run `npx skills add ZJU-REAL/Easel --skill video-chapters -a codex`. Or copy the skill folder (skills/openclaw/video-chapters in ZJU-REAL/Easel) into .agents/skills/video-chapters in your project. Codex loads it when a task matches its description.

Can I use Video Chapters in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZJU-REAL/Easel --skill video-chapters -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/video-chapters, .gemini/skills/video-chapters, .github/skills/video-chapters and .opencode/skills/video-chapters in your project.

What does Video Chapters need to run?

Going by SKILL.md and its folder, Video Chapters needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Video Chapters access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Video Chapters safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Video Chapters use?

Video Chapters is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Video Chapters use?

About 470 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Video Chapters?

Skills that share tags, products or a category with Video Chapters: Youtube Fetcher (JimmySadek/youtube-fetcher-to-markdown, 485 stars), Shorts Video Maker (uxjoseph/content-marketing-team, 107 stars), Watch (mathiaschu/watch, 142 stars) and Watch Video (coreyhaines31/makerskills, 851 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Video Chapters?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,376 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 9, 2026.

Source: ZJU-REAL/Easel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.