11 个技能,做好 YouTube 内容 The YouTube agent skill
围绕 YouTube 内容制作,撰写脚本、搭配标题与封面,依据字幕整理剪辑建议,并结合观众留存数据复盘视频表现。
可用于 Claude Code
前置要求
- Git
- Python 3
概览
你会得到什么
- 11 个技能,覆盖脚本、标题封面、剪辑建议、评论、排期、同类研究、留存、Shorts、简介、章节及频道检查。
- 6 个 Python 脚本,用于开场评分、标题检查、字幕分析、章节划分、留存分析和频道内播放量对比。
- 可修改的脚本、封面设计说明、标明时间点的修改建议,以及记录受众与表达习惯的 voice.md。
适用场景
- 录制前确定视频主线、开场和标题封面。
- 结合已有视频的字幕与观众留存数据,找出优先修改的内容。
- 从长视频中挑选可以独立讲清楚的 Shorts 片段。
不适用
- 渲染动画、实际裁切视频、生成封面图片或上传发布。
- 把面向英文的评分与文字规则直接当作中文文案的判断依据。
教程
先判断它能帮你完成哪一步
它解决什么问题?
有了选题,却不知道第一句怎么说;脚本写好了,标题和封面仍在重复同一句话;视频发出去了,只知道播放量低,不知道先改哪里。这套合集把这些任务拆成 11 个技能,让 Claude 根据你的资料写脚本、设计标题封面组合,并结合字幕和留存数据提出修改建议。
它的主要产出是文稿、设计说明和分析报告。比如讲“开店选址”,可以先把要讲的判断方法整理成脚本,再规划哪些地方需要地图、对比表或现场镜头,最后交给录制、剪辑或动画制作工具完成画面。
它与站内同类有什么区别?
| 站内方案 | 主要解决什么 | 本合集适合接在哪一步 |
|---|---|---|
| Easel:从选题到发布,用 AI 做自媒体 | 在本地工作台组织选题、图文、视频及发布流程 | 集中处理 YouTube 的脚本、标题封面和数据复盘 |
| 16 种画风,把知识讲成动画 | 比较画风样片,制作短知识动画 | 先明确讲解主线与画面安排,再交给动画技能制作 |
| 把文稿做成边画边讲的视频 | 将文稿做成带配音和字幕的手绘视频 | 先打磨稿件与标题;需要手绘成片时再衔接制作流程 |
已有清楚的稿件、只缺画面时,可以直接选择后两项。还在纠结“讲什么、怎样开头、观众为什么离开”,再按下面的任务表选技能。
按任务选择这 11 个技能
下表的 /yt-… 输入 Claude Code 对话,不是终端命令。每次选当前需要的一项,不必按顺序全部运行。
| 技能 | 交付什么 | 需要准备什么 |
|---|---|---|
| yt-script | 开场候选、分段口播稿与画面提示 | 选题、观众、资料与表达习惯 |
| yt-package | 标题与封面文案组合、封面设计说明 | 视频主线或已确认的脚本 |
| yt-edit | 停顿、口头语和重录位置的剪辑建议 | 带时间戳的字幕或转写稿 |
| yt-comment | 评论分类、回复草稿及置顶建议 | 评论内容与自己的回复习惯 |
| yt-plan | 根据可用时间安排的内容计划 | 本周可用工时与已有素材 |
| yt-viral | 相对各自频道常见播放水平表现突出的案例 | 公开的视频标题、播放量及频道信息;每频道至少 4 条 |
| yt-retention | 留存下降位置与优先修改建议 | 留存 CSV;对照内容时再附字幕 |
| yt-shorts | 可独立成篇的短视频候选、时间段及新开场 | 长视频的带时间戳转写稿 |
| yt-seo | 视频简介、搜索词与标签建议 | 视频内容、目标观众和相关链接 |
| yt-chapters | 章节时间点与待润色的章节标题 | 带时间戳的字幕 |
| yt-audit | 频道当前最值得优先做的一项改进 | 最近视频的标题、封面、开场及可用数据 |
yt-edit 和 yt-shorts 提供建议与时间段,实际裁切仍在剪辑软件里完成;yt-package 提供封面设计说明,不生成图片。合集也不自动上传视频或发布评论。
安装并设置自己的表达习惯
安装完整技能目录
本教程采用官方提供的 Claude Code 复制安装方式。准备 Git 和 Python 3,在终端执行:
git clone https://github.com/Jakeschincariol/youtube-agent-skill.git
mkdir -p ~/.claude/skills
cp -r youtube-agent-skill/skills/yt-* ~/.claude/skills/
# 仍在刚才的终端目录,复制表达习惯模板
mkdir -p ~/.claude/youtube
cp youtube-agent-skill/templates/voice.md ~/.claude/youtube/voice.md
应看到 ~/.claude/skills/ 中有 11 个 yt- 技能目录,目录内同时保留 SKILL.md 和随附脚本。不要只复制说明文件:章节和留存脚本会读取相邻技能中的代码,开场评分也会读取 hooks.json。这 6 个 Python 工具只使用标准库,不需要额外安装 Python 包。
让稿件接近你自己的表达
打开 ~/.claude/youtube/voice.md,填写观众、常用说法、不用的词、不做的承诺,以及视频形式。可以保留原模板的标题,用中文填写内容;已有自己的视频时,加入真实转写稿。多数创作技能会先读取这个文件,缺少时会要求提供自己的视频来了解表达习惯。
本次可以填写:观众是第一次筹备开店的人;语气直接、少用术语;用具体情境解释判断过程;不编造经营经历、客流数据或收益。这里记录的是写作与口播习惯,不需要配置配音服务。
新开 Claude Code 会话,输入 /yt-script 并说明选题,确认它能读取你的表达习惯、接收资料并开始提出开场候选。若没有识别命令,先核对技能目录是否位于当前 Claude Code 使用的目录,再重新打开会话。
从一个选题写出脚本,搭配标题与封面
先把选题缩成一个问题
“如何开店选址”可以讲很久。这次只练习“为什么不能只看人流量”:目标是让观众学会区分经过的人和可能进店消费的人。准备店型、你想讲的判断方法,以及可以引用的案例资料;没有案例时,就明确采用标注为假设的教学情境。
下面的请求由本站编写,用于组织练习,未执行脚本创作或视频生成。把方括号内容换成自己的资料,在 Claude Code 中发送:
/yt-script
为第一次准备开店的人,写一条中文知识讲解脚本。
选题:为什么选址不能只看人流量?
店型:[填写店型]。资料:[文件路径或正文]。
只讲清“经过的人”与“可能进店消费的人”的区别。
先给我开场候选,说明各自让观众期待什么,等我选定再写正文。
中文开场另按是否具体、是否贴近观众问题、是否留下值得听下去的问题来解释取舍,
不要用英文评分脚本的排名决定中文稿的优劣。
技能会从 21 种开场结构中提出 5 个候选,并用脚本评分、选出两个供你比较。随附的评分脚本按英文词语和词数设计,不能直接评价中文开场;中文候选应按实际表达判断,分数不作为选择依据。 即使用英文写稿,分数也只检查预设特征,不预测播放表现。
选开场时,看它能否让观众知道后面会得到什么。例如,“人流多就值得租吗?”需要正文给出判断方法;若后面只讲租金,就没有兑现开场承诺。选定后,让 Claude 按“情境 → 对比 → 判断方法 → 总结”完成稿件,每段附画面提示。
得到首版后,自己读一遍:不看画面能否讲通?每段画面是否帮助理解?数字和案例能否追溯到资料?中文时长以实际朗读为准,不套用技能中的英文每分钟 150 词估算。
把标题和封面当成一组来选
确认主线后继续发送:
/yt-package
为刚才确认的脚本设计标题与封面组合,保持中文表达。
标题说明观众会解决的问题,封面补充一个场景或对比,不重复标题。
只使用稿件已有的事实,不添加“亲测”“稳赚”或没有依据的数字。
按技能流程给我候选,推荐三组,并说明各组承诺对应稿件的哪一段。
封面交付构图、主体和文字说明,等我选定后再进入图片制作。
例如,标题“选址只看人流量?先看清谁会进店”可以搭配“两家店门前的人群对比”。这是表达方向,最终内容应按你选定的店型和资料调整。查看缩小后的封面时,主体应容易分辨,文字补充标题的信息;英文脚本的词数、模糊词及重复词检查不能直接替代中文检查。
如果要把开场改成另一个问题,先确认正文也回答了新问题,再更新标题与封面。只调整封面布局时,则明确保留已确认的稿件和事实。稿件确认后,可交给前面链接的动画技能制作画面。
用字幕与留存数据改进下一条视频
录制后,给 yt-edit 带时间戳的 SRT、VTT 或转写 JSON,让它列出建议删减的位置。对照实际画面再决定是否剪掉:演示操作时的停顿可能有用,不能把所有无口播时段都当作废话。口头语和重复句识别同样偏向英文,中文需结合转写稿检查。
视频发布并积累数据后,准备对应视频的观众留存 CSV 与字幕。留存文件至少需要 8 个有效数据点,整理为“播放位置、留存百分比”两列;位置若是百分比,还要提供视频总时长,才能换算到具体秒数。将这些文件交给 Claude Code:
/yt-retention
分析 [留存 CSV 路径],对照 [字幕路径]。
视频总时长:[实际秒数];位置列的单位:[秒或百分比]。
先核对文件格式与时间轴,找出最值得检查的一处下降,
引用附近的字幕,给出下一版的一项具体修改建议。
把数据观察和可能原因分开,缺少依据时不要下因果结论。
先核对报告的时间位置是否对应到正确字幕,再回看视频。留存曲线能提示哪里需要检查,不能单独证明是某一句话、某个镜头或某个转场导致流失。
想把长视频改成 Shorts,再用 yt-shorts 挑选脱离上下文也能听懂的片段,检查新开场、结尾与竖屏裁切;它交付的是候选与改编建议,实际视频仍要剪辑。换成自己的主题时,沿用“明确观众问题 → 写稿 → 搭配标题封面 → 制作 → 对照数据修改”的流程,把资料、表达习惯和发布数据换成自己的。
合集采用 MIT 许可。完整命令与更新说明见仓库 README。