youtube-agent-skill 实战路线图:从零到用 11 个技能运营一条 YouTube 频道的完整上手路径
youtube-agent-skill 实战路线图:从零到用 11 个技能运营一条 YouTube 频道的完整上手路径
youtube-agent-skill 是一套面向 YouTube 频道运营的开源 AI 技能包:11 个 Claude 技能覆盖选题规划、脚本撰写、标题封面包装、剪辑决策、Shorts 切片、留存分析到爆款研究的全流程,内置 6 个可直接运行的 Python 小工具。免费、MIT 协议,无需注册、无需 API 密钥,粘贴一条安装指令就能开始用。
这篇实战路线图会带你走完"从零到运营一条频道"的完整路径:先装好,再按 7 步循环跑起来。
11 个技能一览:YouTube 内容管线全覆盖 🎬
11 个技能各管一件事,正好拼成一条频道运营的完整流水线:
| 命令 | 它做什么 | 技能文档 |
|---|---|---|
/yt-script |
一个想法变脚本:从 21 条钩子公式 里出 5 个开头并打分,再写出口播稿 | skills/yt-script/SKILL.md |
/yt-package |
标题 + 封面当成一个整体来写和检查(截断、重复、含糊) | skills/yt-package/SKILL.md |
/yt-edit |
字幕稿变剪辑决策清单:死气、填充词、重录,带时间码 | skills/yt-edit/SKILL.md |
/yt-comment |
评论区分拣成 4 堆,再按你的语气写回复,并告诉你该置顶哪条 | skills/yt-comment/SKILL.md |
/yt-plan |
按你真实可用的小时数排一周内容 | skills/yt-plan/SKILL.md |
/yt-viral |
找出你领域里真正在涨的视频,按"跑赢本频道中位数几倍"排序 | skills/yt-viral/SKILL.md |
/yt-retention |
读懂 YouTube Studio 的留存导出:开头泄漏、断崖、缓坡 | skills/yt-retention/SKILL.md |
/yt-shorts |
找出长视频里"离开上下文也成立"的 Shorts 片段 | skills/yt-shorts/SKILL.md |
/yt-seo |
写描述、值得留的标签,和这条视频应该赢下哪 3 个搜索词 | skills/yt-seo/SKILL.md |
/yt-chapters |
从字幕稿生成章节,并对照 YouTube 官方规则校验能真正渲染 | skills/yt-chapters/SKILL.md |
/yt-audit |
全盘体检频道,最后只给你一个最该修的点 | skills/yt-audit/SKILL.md |
设计上有两个值得注意的细节:
- 标题和封面是一体:
/yt-package坚持"封面不能重复标题的字",因为分开写往往导致一半点击面说了两遍同样的话。 - 审计只给一个结论:
/yt-audit明确反对"列出 20 个问题"的审计方式,收尾永远是 ONE fix。
最快安装步骤:3 种方式任选
方式一:让 Claude 自己装(最省事)
把仓库地址 + "Install this skill, then confirm /yt-script works." 粘给 Claude 即可。
方式二:手动复制(Claude Code)
git clone https://gitcode.com/gh_mirrors/yo/youtube-agent-skill.git
cp -r youtube-agent-skill/skills/yt-* ~/.claude/skills/
方式三:作为插件安装
/plugin marketplace add Jakeschincariol/youtube-agent-skill
/plugin install youtube
也可以只放进项目的 .claude/skills/ 做项目级使用。没有 Claude Code 也没关系:把任意一个 SKILL.md 粘到对话开头就能当模式用——代价是失去 6 个 Python 工具,而那正是 /yt-script、/yt-retention、/yt-edit 的核心价值。
安装方法详见 README.md 的 Install 一节。
关键第一步:花 10 分钟写好 voice.md 🎙️
所有技能都会先读 ~/.claude/youtube/voice.md——这是你的"声音档案":怎么说话、哪些词从不用、不承诺什么。
为什么它比任何提示词都重要?因为口播稿是要你亲口念出来的,用错语气的脚本比没有脚本更糟。
- 模板见 templates/voice.md,复制后填写,或直接把你自己 3 条视频的稿子发给 Claude 让它代写
- 要填的核心 5 项:我在对谁说话、我真实的说话方式、绝不用的词、我惯用的词、我不会声称的事
完整路线图:每周运营循环 7 步走 ✅
装好之后,一条频道的日常运营可以完全按这个循环跑:
第 1 步:/yt-plan 排本周
它会先问两个问题:你这周实际有多少小时、哪些东西已经做了一半。产出的标准一周是:1 条主打长视频 + 1 条低成本视频(用现成素材)+ 3 条从长视频切出来的 Shorts。不追求日更,留白让坏的一周也能撑住。
第 2 步:/yt-script 写脚本
给它一个想法,它会写出 5 个钩子、跑打分工具、留下最好的 2 个给你选(它从不只交 1 个钩子),然后是按节拍写的完整口播稿,每个节拍都标注 [ON SCREEN: ...] 画面提示,并按 150 词/分钟估算时长。
钩子来自 hooks.json 里的 21 条公式(如 The Statistic、Someone Else's Result),每条都带结构、范例和失效条件。
第 3 步:/yt-package 包装
生成 10 个标题全部过一遍检查工具,展示前 3 名及各自的问题,再为胜选标题写封面简报。工具强制的规则很具体:60 字符是桌面搜索截断线、40 是手机首页截断线;封面最多 3 个词;两个全大写单词是标题的"垃圾邮件"上限。
第 4 步:/yt-edit + /yt-chapters 出片
录制完拿到字幕稿(srt / vtt / whisper json 都行):
/yt-edit输出剪辑决策清单:死气段(从中间剪、两边各留一口气)、纯填充词、重录句,全部带时间码。它只出清单不动素材,剪完自己对着片子核对/yt-chapters按"词汇漂移"定位章节边界,并强制校验 YouTube 的三条硬规则:首条必须是 00:00、至少 3 条、每条至少 10 秒——不达标直接告诉你,而不是让你贴进去悄悄失效
第 5 步:/yt-shorts + /yt-seo 发片前收尾
/yt-shorts在字幕里找 20–55 秒"开头是完整思考、中间有转折、结尾收在一句话上"的片段,并为每条 Short 重写开头第一句、配前 2 秒屏显文字和循环点/yt-seo写描述(前 2 行就是搜索摘要)、克制地用标签(它坦承标签是弱信号),最后用"查询测试"自检:这条视频该赢的 3 个搜索词,标题和描述前 2 行里是否都有
第 6 步:/yt-retention 读留存数据
在 YouTube Studio → Analytics → Engagement 导出"观众留存"CSV,它会区分三种完全不同的问题:
- HOOK LEAK:前 30 秒流失,低于 25% 算健康;修法是改脚本开头 15 秒,不是改剪辑
- CLIFFS:单点陡降;配
--transcript能直接打印出那一秒你正在说什么 - SLIDE:中段的持续阴跌;修法是剪,不是重写
第 7 步:/yt-viral + /yt-audit 反哺下一轮
/yt-viral收集你领域竞品的公开列表(只读不爬、不碰你的账号),按"跑赢各自频道中位数几倍"排序找异常值——因为裸播放量排出来的是频道大小,不是选题好坏- 跑一轮
/yt-audit做频道级体检(最近 10 个标题当一组看、封面缩到信息流尺寸看、最近 3 条前 15 秒打分、发布节奏看一致性不看频率),拿到那一个最该修的点
发布后还有 /yt-comment 把评论区分拣成问题/纠错/赞美/钓鱼四堆,并告诉你该置顶哪条。
6 个 Python 工具:技能不只是提示词 🛠️
这套包和"纯提示词"最大的区别是 skills/ 里 6 个零依赖(干净 Python 3 即可)的可运行工具:
python3 skills/yt-script/hookscore.py --hook "one line" # 钩子 5 维面板
python3 skills/yt-package/title.py --title "..." --thumb "..." # 标题+封面检查
python3 skills/yt-edit/deadair.py transcript.srt # 剪辑决策清单
python3 skills/yt-chapters/chapters.py transcript.srt # 章节校验
python3 skills/yt-retention/retention.py retention.csv # 留存分析
python3 skills/yt-viral/swipe.py collected.json --min 2.0 # 爆款排序
其中 hookscore.py 的评分逻辑值得一提:5 个维度各 0–100 分,总分 = 60% 平均 + 40% 最低分——短板加权是故意的,四个维度强、一个维度死的钩子,就死在那个缺口上。
使用边界:这些坑提前知道 ⚠️
项目的 README.md 专门列了"别人包装里最常被省掉的部分",照单理解就不会用错:
- 它不发布——每个技能都以"ship it, or change it?"结尾,写稿的是它,上传的是你。任何号称无人值守运营频道的说法都该带着这个区别去读
- hookscore 是启发式,不是预测器——它基于 74 条真实短视频开头校准,能很好地区分烂钩子和正常钩子,但区分"你自己的爆款 vs 自己的扑街"能力有限;低分是让你再看一眼的理由,高分不是承诺
- 公式分类只判断标题文字——
/yt-viral说某标题用了 The Statistic,是对可见标题的判断,不是对视频为何火的原因归因 - 只读不爬——
/yt-viral只用公开列表,从不登录、从不碰你的凭据 - 不编造数字——任何一个技能缺数据时要么问你,要么把那句话空着写
路线图总结 🚀
用一句话串起整条路径:
voice.md 定语气 → yt-plan 排一周 → yt-script 写脚本 → yt-package 包装 → yt-edit/yt-chapters/yt-shorts/yt-seo 出片 → yt-retention 读数据 → yt-viral/yt-audit 找下一轮方向。
11 个技能 + 6 个工具,零 API 密钥、MIT 免费。今晚就把仓库 clone 下来,先用 /yt-script 跑通第一个钩子,你的频道运营管线就转起来了。