youtube-clipper

youtube-clipper 技能概览

youtube-clipper 的作用

youtube-clipper 是一个可安装的工作流，用来把 YouTube 视频转换成可用的片段、字幕变体和简短摘要。它面向的不是“随手给个 prompt 就行”的场景，而是希望以更少人工操作，重复完成下载、分析、剪辑、翻译和导出视频片段的用户。

适合使用这项技能的场景

如果你经常处理访谈、讲座、播客、教程或创作者视频，并且需要干净利落的片段用于二次发布、审阅或做笔记，那么这个 youtube-clipper 技能非常合适。尤其是在 youtube-clipper for Video Editing 这类场景里，真正的任务是“找出最佳片段、剪出来、做成可发布内容”，而不只是“下载一个文件”。

主要差异点

不同于一次性的 prompt，youtube-clipper 把视频下载、语义分章、字幕翻译和字幕烧录整合进同一套流程。它的实际价值在于，能先基于内容帮 agent 做编辑判断，再把这些判断一路传递到可直接导出的片段和双语输出中。

如何使用 youtube-clipper 技能

安装并验证环境

先按仓库提供的安装路径操作，然后确认相关工具都可用。推荐的 youtube-clipper 安装方式是：
npx skills add https://github.com/op7418/Youtube-clipper-skill

安装后，先查看 README.md 了解安装路径，再检查 SKILL.md 和驱动行为的辅助文件。这个技能依赖 yt-dlp、pysrt 和 python-dotenv 等 Python 包；如果你计划烧录字幕，还需要带有 libass 支持的 FFmpeg。

给技能提供合适的输入

想让 youtube-clipper 发挥得更好，请提供：

• YouTube URL
• 目标结果：片段、双语字幕、烧录字幕，还是摘要
• 任何时间限制、语言偏好或片段长度偏好
• 你希望按章节选段，还是要指定某个具体区间

差的请求是“把这视频剪一下”。更好的请求是：“用 youtube-clipper 分析这段 45 分钟访谈，找出 3 到 5 个围绕产品策略的有意义片段，并导出带双语字幕的最佳 2 分钟剪辑。”

先读这些文件

先从 SKILL.md 入手，理解整体工作流，然后再看：

• README.md：安装和使用背景
• references/yt-dlp-guide.md：下载行为
• references/ffmpeg-guide.md：字幕和导出要求
• references/subtitle-formatting.md：字幕样式预期
• scripts/download_video.py、scripts/analyze_subtitles.py 和 scripts/clip_video.py：实际执行路径

这个顺序很重要，因为它能看出 youtube-clipper 哪些地方依赖本地工具，哪些地方是在其上叠加 AI 驱动的选段能力。

能明显提升输出质量的工作流建议

建议把 youtube-clipper 当作分阶段工作流来用：先下载，再检查章节建议，最后只剪出符合目标的片段。如果你打算烧录字幕，先确认 FFmpeg 支持，再提出导出需求。如果源视频字幕质量不好，也要提前说明，这样技能就能改用基于转写稿的分析，而不是默认输入字幕干净可用。

youtube-clipper 技能常见问题

youtube-clipper 比普通 prompt 更好吗？

通常是的，尤其是当你需要一套可重复的编辑流程时。普通 prompt 可以描述一个片段，但 youtube-clipper 能给 agent 提供一条可执行的路径：下载、分析、剪辑、字幕翻译和导出。这样能减少猜测，也更利于在不同视频上稳定使用 youtube-clipper。

我需要视频剪辑经验吗？

不需要。这个技能对新手也有帮助，因为它把任务结构化了，但你仍然需要告诉它“什么算好”。如果你只想要一个粗略的社媒短片，就直接说；如果你要按章节精确截取，也要明确说明。

什么时候不该用它？

如果你只需要一条快速笔记或一个单独的时间戳引用，就不必用 youtube-clipper。它也不适合你无法安装本地工具的时候，尤其是 FFmpeg 和 yt-dlp；或者视频源不是这个工作流能够访问的 YouTube URL 时，也不适合。

它适合双语或内容再利用工作流吗？

适合。这个仓库就是为翻译、双语字幕和可发布的片段输出而设计的，所以它非常适合需要下游素材，而不只是一个裁剪过的 MP4 的创作者。这也是选择这个 youtube-clipper 技能而不是通用视频 prompt 的主要原因。

如何改进 youtube-clipper 技能

给出更清晰的编辑意图

决定结果好坏的最大因素，是你的选段说明。不要只说“做几个片段”，而要明确受众、语气和用途：高光集、教学剪辑、金句片段，还是摘要摘录。这样能帮助 youtube-clipper 选出更相关的片段，避免机械上有趣、编辑上却不够有价值的部分。

尽早给出约束条件

尽早说明片段长度、字幕语言，以及是否需要硬编码字幕。如果你知道视频里有多位说话人、音频嘈杂，或者是自动生成字幕，也要一并说明。这些信息能减少返工，因为技能可以在开始剪辑前就围绕字幕质量和导出限制做计划。

注意常见失败模式

最常见的问题是工具不匹配和源素材质量不清楚：

• 没有 libass 的 FFmpeg 会阻止字幕烧录
• 缺少 yt-dlp 会阻止下载
• 弱字幕会降低分章质量
• 过于模糊的 prompt 会产出范围过大、不可用的片段

如果第一次输出范围太宽，就把要求收紧：减少片段数量、缩短片段长度，或者指定更具体的主题窗口。

从分析迭代到导出

把第一轮结果当作决策层，而不是最终答案。先让 youtube-clipper 围绕最好的片段边界继续细化，然后在你确认分章后再请求导出。对于 youtube-clipper for Video Editing 来说，这种两步式循环通常比试图一次性生成最终成品更容易得到更干净的剪辑。