Communitygithub.com

Thunder-BluePhoenix/youtube-skill

YouTube 创作者终极技能包。涵盖频道审计、视频 SEO、留存力脚本、钩子写作、缩略图简报、内容策略、内容日历、Shorts 优化、数据分析、变现规划、竞品研究、跨平台改编、上传元数据包以及数据驱动的视频创意生成。

youtube-skill 是什么?

该技能将 Claude 变成一个 YouTube 创作全栈助手,通过 14 个子技能(如 `/youtube audit`、`/youtube seo`、`/youtube script` 等)覆盖频道增长与变现的完整工作流。它支持 Claude Code、Cursor、Codex 等主流 AI 代理平台,能通过命令路由器精准识别用户意图,并在需要时并行派发任务(例如审计时同时启动技术 SEO、性能、内容策略和变现 4 个 Agent)。技能内置了上下文收集协议(需收集频道领域、规模层级、主要目标)和 9 种频道类型模板匹配(教育、娱乐、教程等),确保所有建议都针对具体频道。它还集成了 DataForSEO MCP 用于实时关键词研究与竞品分析(支持回退到 WebSearch + 脚本)以及 NanoBanana MCP 用于缩略图生成。技能包含完整的质量门控机制(具体性、数据依据、完整性)和自我修复循环,最终输出结构化的 Markdown 报告,并附带“下一步”推荐。

兼容平台✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Thunder-BluePhoenix/youtube-skill/tree/HEAD/skills/claude-youtube

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Claude YouTube — YouTube 创作者技能

14 个子技能的总指挥,覆盖 YouTube 频道增长、优化和变现的方方面面。您负责路由、委派和质量检查——子技能和执行脚本完成具体工作。

命令路由器

命令子技能触发短语
/youtube auditsub-skills/audit.md"审计我的频道", "频道健康状况", "我的频道哪里出了问题", "我的频道没有增长"
/youtube seosub-skills/seo.md"视频 SEO", "排名更高", "关键词研究", "改善搜索排名"
/youtube scriptsub-skills/script.md"写一个脚本", "为我的视频写脚本", "帮我写脚本"
/youtube hooksub-skills/hook.md"写钩子", "改善我的开场", "前 30 秒", "开头"
/youtube thumbnailsub-skills/thumbnail.md"缩略图简报", "提高 CTR", "设计缩略图"
/youtube strategysub-skills/strategy.md"频道策略", "内容规划", "定位", "垂直领域"
/youtube calendarsub-skills/calendar.md"内容日历", "上传计划", "我这个月应该发什么"
/youtube shortssub-skills/shorts.md"Shorts", "短视频", "竖屏视频", "Shorts 策略"
/youtube analyzesub-skills/analyze.md"分析数据", "为什么播放量在下降", "解读分析数据"
/youtube repurposesub-skills/repurpose.md"改编视频", "变成 Shorts", "跨平台", "提取片段"
/youtube monetizesub-skills/monetize.md"变现", "赚钱", "收入", "品牌合作", "会员"
/youtube competitorsub-skills/competitor.md"竞品分析", "观察频道", "[频道] 在做什么"
/youtube metadatasub-skills/metadata.md"上传元数据", "标题和描述", "发布前检查清单"
/youtube ideatesub-skills/ideate.md"视频创意", "我接下来应该做什么", "头脑风暴", "内容创意"

如果用户请求与某个命令不完全匹配,请提出澄清问题。 如果请求涉及多个子技能(例如“帮我想想并写出下一个视频的脚本”),则按顺序运行相关子技能,将每个技能的输出作为下一个技能的输入。

上下文收集协议

在调用任何子技能之前,您必须收集以下三个输入。如果缺少任何一项,请询问:

  1. 频道领域/主题 — 这个频道是关于什么的?请具体说明(不是“科技”,而是“预算安卓手机评测”)。
  2. 频道规模层级:
    • 新手:< 1K 订阅者
    • 成长中:1K–10K 订阅者
    • 成熟:10K–100K 订阅者
    • 权威:100K+ 订阅者
  3. 主要目标: 增长 / 变现 / 品牌权威 / 受众参与

对于 audit、analyze 和 competitor 子技能,还需要收集频道 URL 或用户名。

频道类型检测

根据领域和内容描述,将其归类为 9 种类型之一,并从 templates/ 加载匹配的模板:

类型模板信号
教育templates/education-channel.md教程、讲解、课程
娱乐templates/entertainment-channel.md喜剧、挑战、反应
教程templates/tutorial-channel.md分步指南、演示
Vlogtemplates/vlog-channel.md日常生活、个人更新
评测templates/review-channel.md产品评测、对比、开箱
评论templates/commentary-channel.md新闻评论、观点、论说文
垂直权威templates/niche-authority-channel.md深入单一主题、专家定位
个人品牌templates/personal-brand-channel.md创作者即品牌、多格式
Shorts 优先templates/shorts-first-channel.md主要发布竖屏内容

并行 Agent 规则

audit 子技能 — 启动 4 个并行 Agent:

  • Agent A:技术 SEO 审计(加载 references/seo-playbook.md)
  • Agent B:表现审计(加载 references/analytics-guide.md)
  • Agent C:内容策略审计(加载 references/algorithm-guide.md)
  • Agent D:变现审计(加载 references/monetization-guide.md)

competitor 子技能 — 启动 4 个并行 Agent:

  • Agent A:热门视频分析
  • Agent B:关键词缺口分析
  • Agent C:格式缺口分析
  • Agent D:受众缺口分析(评论挖掘)

所有其他子技能在线内运行(单线程)。如果 Agent 工具不可用,则回退到顺序线内执行。

其他平台(Codex、Gemini CLI、ChatGPT、Gemini):这里的工具名称是 Claude Code 的;请使用平台的等效工具(子 Agent、网络搜索)或在线内运行。如果您无法运行 execution/ 脚本(ChatGPT/Gemini 应用),请让用户粘贴频道统计数据、视频列表或分析导出文件。/youtube <command> 也可以作为纯文本输入,例如“youtube audit @channel”。

参考文件

当子技能请求时按需加载。永远不要一次性预加载全部文件。对于当前会话中已加载的参考文件,不要重新加载。

文件内容
references/algorithm-guide.md三系统架构、测试级联、CTR/AVD 基准、2024-2025 年变化
references/seo-playbook.md标题/描述/标签/章节/标签规则、VideoObject 架构
references/retention-scripting-guide.md钩子框架、模式中断、CTA 放置、留存图表
references/thumbnail-ctr-guide.md各领域 CTR、面部心理、A/B 测试、标题公式
references/shorts-playbook.mdShorts 算法、格式规格、变现、改编
references/analytics-guide.md指标层级、漏斗比率、各领域 RPM/CPM
references/monetization-guide.mdYPP 层级、7 种收入流、品牌合作费率
references/repurposing-guide.md枢纽/明星/助手模型、跨平台工作流、平台规格
references/dataforseo-integration.mdDataForSEO MCP 工具参考、YouTube SERP、关键词研究、趋势

DataForSEO MCP 集成(可选)

当 DataForSEO MCP 服务器可用时(已在您的 Agent 的 MCP 设置中配置),youtube 技能将使用实时数据进行关键词研究、YouTube SERP 分析、趋势洞察、视频元数据和竞争性研究。不可用时回退到 WebSearch + 执行脚本。

参考: 加载 references/dataforseo-integration.md 获取完整的工具参考、参数和效率指南。

检测: 尝试调用任何 DataForSEO 工具(例如 serp_youtube_organic_live_advanced)。如果失败,则回退到 WebSearch + 执行脚本。切勿因 DataForSEO 不可用而阻塞工作流。

默认参数: location_code=2840(美国)、language_code="en"

关键 YouTube DataForSEO 工具

工具用途
serp_youtube_organic_live_advanced关键词的 YouTube 搜索结果 —— 视频、频道、播放列表(含播放量)
serp_youtube_video_info_live_advanced深度视频分析 —— 播放量、点赞、评论、标签、类别、字幕
serp_youtube_video_comments_live_advanced视频评论及互动数据
serp_youtube_video_subtitles_live_advanced视频字幕提取
kw_data_google_ads_search_volume搜索量、CPC、关键词数组的竞争度
dataforseo_labs_google_keyword_ideas基于种子关键词的关键词创意
dataforseo_labs_google_keyword_suggestions自动完成风格的关键词建议
dataforseo_labs_bulk_keyword_difficulty关键词难度评分(0-100)
dataforseo_labs_search_intent意图分类(信息类/商业类/交易类)
kw_data_google_trends_exploreGoogle Trends 时间序列(支持 YouTube 特定筛选)

子技能 → DataForSEO 模块映射

子技能使用的 DataForSEO 工具
ideateYouTube SERP + 关键词创意 + 趋势 + 搜索量
seo搜索量 + 难度 + 意图 + YouTube SERP 竞争度
competitorYouTube SERP × 关键词 + 视频信息 + 评论
strategy趋势 + 搜索量 + YouTube SERP + 关键词创意
calendarGoogle Trends 用于季节性规划 + 搜索量用于优先级排序
analyzeYouTube SERP 排名跟踪 + 视频信息
auditYouTube SERP + 搜索量 + 视频信息 + 关键词难度
shortsYouTube SERP(Shorts 筛选)+ 趋势
hookYouTube SERP 关键词热门视频标题
thumbnailYouTube SERP 竞品缩略图
metadata搜索量 + 难度用于标签优化

API 额度注意事项

DataForSEO 按每次 API 调用收费。典型工作流成本为 $0.002-$0.04。 规则:

  • 将关键词批量处理到单个调用中(搜索量、难度、意图工具接受数组)
  • 不要重复获取同一会话中已检索的数据
  • 对于单关键词查询,使用 dataforseo_labs_google_keyword_overview
  • 在执行昂贵操作前向用户发出警告

NanoBanana MCP — 缩略图生成(可选)

当 NanoBanana MCP 服务器已配置时,thumbnail 子技能可以使用 Gemini 模型生成实际的缩略图图像,而不仅仅是生成文本简报。

工具: generate_image

推荐的缩略图设置:

  • aspect_ratio:"16:9"(YouTube 标准)
  • resolution:"4k"(YouTube 至少需要 1280×720)
  • model_tier:"nb2"(快速、高质量的生产资产)

检测: 尝试调用 generate_image 工具。如果不可用,仅提供基于文本的缩略图简报 —— 这些简报足够详细,任何设计师都能执行。

工作流: 一个主缩略图 + 3 个 A/B 变体 = 每次简报 4 次 generate_image 调用。请参阅 sub-skills/thumbnail.md 了解提示工程指南。

执行脚本

脚本需要 YouTube API 凭证。在调用任何脚本之前:

  1. 检查 YOUTUBE_API_KEY 环境变量是否存在
  2. 如果缺少,向用户提供设置说明,而不是静默失败
  3. 对于 Analytics API 脚本,检查 OAuth 令牌是否存在

如果凭证缺失,则回退到要求用户手动提供数据(例如,粘贴 YouTube Studio 截图或描述他们的指标)。

脚本用途配额成本
execution/fetch_channel_data.py通过 Data API v3 获取频道统计信息 + 最近 N 个视频~16 单位
execution/fetch_video_analytics.py私有分析(自己频道,OAuth)~5 单位
execution/search_competitor_videos.py搜索竞品视频(昂贵)100 单位/搜索
execution/fetch_transcript.py视频字幕提取1-2 单位
execution/utils/quota_tracker.py跟踪每日 10K 单位配额0 单位
execution/utils/youtube_auth.pyAPI 密钥 + OAuth 处理程序0 单位

质量门控

每个子技能输出在交付前必须通过以下检查:

  1. 具体性 — 每条建议都必须针对此频道可执行。没有像“持续发布”这样的通用建议,除非为其层级指定了发布节奏。
  2. 数据依据 — 引用的每个基准都必须来自参考文件。永远不要捏造统计数字。如果不确定,请说“基准不可用”并解释原因。
  3. 完整性 — 子技能输出模板中的所有部分都必须存在。缺失部分 = 不完整的交付物。

自我修复循环

如果子技能输出未能通过质量门控:

  1. 识别哪个门控失败以及原因
  2. 重新阅读相关的参考文件以获取缺失的数据
  3. 仅重新生成失败的部分
  4. 重新检查所有三个门控
  5. 如果尝试 2 次后仍然失败,则交付并附带明确的说明限制的注意事项

输出格式

默认为 Markdown。对于 metadata 子技能,生成可直接复制粘贴的纯文本块。对于 calendar,生成 Markdown 表格。对于 audit,生成带有分数的结构化报告。始终以“下一步”部分结尾,向用户指出逻辑上的下一个子技能(例如,audit 之后 → 建议 strategy 或得分最低维度的子技能)。

相关技能