前言¶
做二創、解說或口播時，常見做法是手動開字幕、複製文稿，再對照時間軸改寫成中文。步驟多，且很難保留原片的段落節奏。若你已經在用 Agent 處理內容生產，可以把「取字幕 → 寫口播 → 對齊結構」交給 Skill，而不是每次從零拼提示詞。
下面介紹 SkillHub 上的 視頻字幕提取（@beatra-ai/youtube-caption-studio）：輸入一條 YouTube 鏈接或你已複製的字幕，輸出能直接唸的中文口播稿，並帶上順着原片的復刻結構。
這是什麼¶
視頻字幕提取 是發佈者 beatra 在 SkillHub 上架的企業來源 Skill（座標 @beatra-ai/youtube-caption-studio，當前版本 0.1.9，分類 content-creation）。它面向「視頻字幕 / 字幕提取 / YouTube 字幕 / YouTube 文稿 / 口播復刻」這一類工作流：從公開視頻或現成文稿出發，生成口播中文，並儘量貼合原片節拍。
官方說明標註 requires_api_key=false，即按頁面信息不強制單獨配置 API Key（具體仍取決於你使用的 Agent 與網絡環境）。
核心功能¶
依據 SkillHub 與官方簡介，已覈實的能力包括：
- YouTube 字幕讀取：給定公開視頻的鏈接，工作流會讀取 YouTube 字幕，作爲後續改寫的基礎。
- 粘貼字幕直用：若你已有複製好的字幕或文稿，可直接粘貼，跳過在線抓取環節。
- 中文口播稿：在字幕/文稿基礎上，寫成適合口播的中文表達。
- 復刻結構：輸出不只是一段譯文，而是帶着「順着原片」的段落與節拍結構，便於對照原視頻錄製或剪輯。
- 可選讀評論：按需要可納入 YouTube 評論信息（官方簡介中爲「也可以按需要讀評論」，是否啓用由對話中說明）。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。在 SkillHub 技能頁上，官方給出的安裝提示是：讓 Agent 參照 SkillHub 安裝文檔，安裝 @beatra-ai/youtube-caption-studio。
若本機已安裝 SkillHub CLI，可按文檔第三節將技能裝進當前 Agent 識別的 skills 目錄（文檔強調必須用 --dir，否則默認 ./skills/ 可能不會被 Agent 加載）：
command -v skillhub && skillhub --version
未安裝 CLI 時，可使用文檔中的安裝腳本（完整安裝或僅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 示例（將 <skills 目錄> 換成你當前客戶端的路徑）：
skillhub install @beatra-ai/youtube-caption-studio --dir <skills 目錄>
文檔列出的常用目錄包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
裝好後按你所用客戶端的要求重啓或刷新 Agent，使 Skill 生效。
典型用法¶
官方未提供單獨的長示例倉庫；用法可從簡介反推爲兩類輸入，在對話中啓用該 Skill 後說明需求即可。
方式一：YouTube 鏈接
- 確認視頻爲可訪問的公開內容，且具備可讀字幕（或 Agent 能按 Skill 工作流獲取字幕）。
- 在對話中給出鏈接，並說明需要「中文口播稿」和「復刻結構」。
- 若需要結合評論區信息，在請求中寫明「需要讀評論」或類似說明。
方式二：已複製的字幕/文稿
- 將字幕或文稿粘貼到對話中。
- 說明目標爲口播中文，並保留原片段落節奏。
- 根據輸出結構調整錄製或分鏡。
具體輸出字段與排版由 SKILL.md 與工作流定義；未在公開頁單獨列出的參數，此處不臆造。
適用場景與注意¶
適合誰
- 需要從 YouTube 公開內容快速拉出字幕並改口播的創作者、運營或開發者。
- 已有字幕文本，只想統一改成中文口播並對齊原片結構的用戶。
需要注意
- 依賴 YouTube 可訪問性與字幕可用性；無字幕或區域限制時，應優先走「粘貼文稿」路徑。
- 評論讀取爲可選能力，涉及隱私與平臺規則時自行判斷是否使用。
- SkillHub 頁面顯示版本 0.1.9；評分 100000、下載 5598（以頁面統計爲準，會隨時間變化）。
- 復刻結構指節奏與段落層面的對齊，不等同於版權授權；二次創作仍需遵守原視頻與平臺條款。
結尾¶
視頻字幕提取 把「鏈接觸發或粘貼字幕 → 中文口播 → 復刻節拍」收進一條 Skill 工作流，減少手工拷字幕和對軸的時間。安裝與詳情見 SkillHub：
- 技能頁：https://www.skillhub.cn/skills/beatra-ai/youtube-caption-studio
- API 座標頁：https://api.skillhub.cn/beatra-ai/youtube-caption-studio
