Communitygithub.com

Thunder-BluePhoenix/youtube-skill

終極 YouTube 創作者技能。涵蓋頻道審核、影片 SEO、留存導向腳本、鉤子撰寫、縮圖簡報、內容策略、內容行事曆、Shorts 優化、數據分析、營利規劃、競品研究、跨平台轉製、上傳中繼資料包,以及數據驅動的影片點子生成。

youtube-skill 是什麼?

這是一個專為 YouTube 創作者設計的完整 AI 技能套件,整合了 14 個子技能,涵蓋從頻道審核到營利優化的所有面向。它可以辨識使用者的頻道類型(如教育、娛樂、評論等),並根據頻道規模與主要目標(成長/營利/品牌權威/觀眾互動)提供個人化建議。支援 Claude Code、Codex、Gemini CLI 等平台,亦可透過 DataForSEO MCP 伺服器獲取即時 YouTube 搜尋資料與關鍵字洞察,或透過 NanoBanana MCP 生成縮圖。技能內建品質控管機制(三大閘門:具體性、資料根據、完整性)與自我修正迴圈,確保每次輸出的建議都精準且可行。對於無法直接使用 API 的環境,它也提供手動輸入數據的退路,讓不同平台的創作者都能受益。

相容平台✓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. 頻道利基/主題 — 頻道主要是關於什麼?要具體(不是 "科技" — 而是 "平價 Android 手機評測")。
  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以直式內容為主

平行代理規則

audit 子技能 — 啟動 4 個平行代理:

  • 代理 A:技術 SEO 審核(載入 references/seo-playbook.md)
  • 代理 B:成效審核(載入 references/analytics-guide.md)
  • 代理 C:內容策略審核(載入 references/algorithm-guide.md)
  • 代理 D:營利審核(載入 references/monetization-guide.md)

competitor 子技能 — 啟動 4 個平行代理:

  • 代理 A:頂尖影片分析
  • 代理 B:關鍵字缺口分析
  • 代理 C:格式缺口分析
  • 代理 D:觀眾缺口分析(留言挖掘)

所有其他子技能以內聯方式執行(單執行緒)。如果代理工具不可用,則退回到循序內聯執行。

其他平台(Codex、Gemini CLI、ChatGPT、Gemini):此處的工具名稱是 Claude Code 的;請使用該平台的等效工具(子代理、網路搜尋)或直接以內聯方式執行。如果你無法執行 execution/ 腳本(ChatGPT/Gemini 應用程式),請要求使用者貼上頻道統計資料、影片清單或分析報表。/youtube <command> 也可以用純文字輸入,例如 "youtube audit @channel"。

參考檔案

在子技能要求時才載入。切勿一次預載所有檔案。對於本次會話中已載入的參考檔案,請勿重複載入。

檔案內容
references/algorithm-guide.md3 系統架構、測試串聯、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.mdHub/Hero/Help 模型、跨平台工作流程、平台規格
references/dataforseo-integration.mdDataForSEO MCP 工具參考、YouTube SERP、關鍵字研究、趨勢

DataForSEO MCP 整合(選用)

當 DataForSEO MCP 伺服器可用時(已在代理程式的 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,產生帶有分數的結構化報告。 務必在結尾加上「下一步」部分,引導使用者指向邏輯上下一個子技能(例如審核後 → 建議 strategy 或分數最低維度的子技能)。

相關技能