前言¶
做二创、解说或口播时，常见做法是手动开字幕、复制文稿，再对照时间轴改写成中文。步骤多，且很难保留原片的段落节奏。若你已经在用 Agent 处理内容生产，可以把「取字幕 → 写口播 → 对齐结构」交给 Skill，而不是每次从零拼提示词。
下面介绍 SkillHub 上的 视频字幕提取（@beatra-ai/youtube-caption-studio）：输入一条 YouTube 链接或你已复制的字幕，输出能直接念的中文口播稿，并带上顺着原片的复刻结构。
这是什么¶
视频字幕提取 是发布者 beatra 在 SkillHub 上架的企业来源 Skill（坐标 @beatra-ai/youtube-caption-studio，当前版本 0.1.9，分类 content-creation）。它面向「视频字幕 / 字幕提取 / YouTube 字幕 / YouTube 文稿 / 口播复刻」这一类工作流：从公开视频或现成文稿出发，生成口播中文，并尽量贴合原片节拍。
官方说明标注 requires_api_key=false，即按页面信息不强制单独配置 API Key（具体仍取决于你使用的 Agent 与网络环境）。
核心功能¶
依据 SkillHub 与官方简介，已核实的能力包括：
- YouTube 字幕读取：给定公开视频的链接，工作流会读取 YouTube 字幕，作为后续改写的基础。
- 粘贴字幕直用：若你已有复制好的字幕或文稿，可直接粘贴，跳过在线抓取环节。
- 中文口播稿：在字幕/文稿基础上，写成适合口播的中文表达。
- 复刻结构：输出不只是一段译文，而是带着「顺着原片」的段落与节拍结构，便于对照原视频录制或剪辑。
- 可选读评论：按需要可纳入 YouTube 评论信息（官方简介中为「也可以按需要读评论」，是否启用由对话中说明）。
安装与启用¶
Skill 基于通用 SKILL.md 格式。在 SkillHub 技能页上，官方给出的安装提示是：让 Agent 参照 SkillHub 安装文档，安装 @beatra-ai/youtube-caption-studio。
若本机已安装 SkillHub CLI，可按文档第三节将技能装进当前 Agent 识别的 skills 目录（文档强调必须用 --dir，否则默认 ./skills/ 可能不会被 Agent 加载）：
command -v skillhub && skillhub --version
未安装 CLI 时，可使用文档中的安装脚本（完整安装或仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 示例（将 <skills 目录> 换成你当前客户端的路径）：
skillhub install @beatra-ai/youtube-caption-studio --dir <skills 目录>
文档列出的常用目录包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
装好后按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。
典型用法¶
官方未提供单独的长示例仓库；用法可从简介反推为两类输入，在对话中启用该 Skill 后说明需求即可。
方式一：YouTube 链接
- 确认视频为可访问的公开内容，且具备可读字幕（或 Agent 能按 Skill 工作流获取字幕）。
- 在对话中给出链接，并说明需要「中文口播稿」和「复刻结构」。
- 若需要结合评论区信息，在请求中写明「需要读评论」或类似说明。
方式二：已复制的字幕/文稿
- 将字幕或文稿粘贴到对话中。
- 说明目标为口播中文，并保留原片段落节奏。
- 根据输出结构调整录制或分镜。
具体输出字段与排版由 SKILL.md 与工作流定义；未在公开页单独列出的参数，此处不臆造。
适用场景与注意¶
适合谁
- 需要从 YouTube 公开内容快速拉出字幕并改口播的创作者、运营或开发者。
- 已有字幕文本，只想统一改成中文口播并对齐原片结构的用户。
需要注意
- 依赖 YouTube 可访问性与字幕可用性；无字幕或区域限制时，应优先走「粘贴文稿」路径。
- 评论读取为可选能力，涉及隐私与平台规则时自行判断是否使用。
- SkillHub 页面显示版本 0.1.9；评分 100000、下载 5598（以页面统计为准，会随时间变化）。
- 复刻结构指节奏与段落层面的对齐，不等同于版权授权；二次创作仍需遵守原视频与平台条款。
结尾¶
视频字幕提取 把「链接触发或粘贴字幕 → 中文口播 → 复刻节拍」收进一条 Skill 工作流，减少手工拷字幕和对轴的时间。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/beatra-ai/youtube-caption-studio
- API 坐标页：https://api.skillhub.cn/beatra-ai/youtube-caption-studio
