前言¶

在 Cursor、Claude Code 等環境裏做素材整理時，常見需求是：用戶丟一條視頻鏈接，希望 Agent 能下載、抽音頻或字幕，或按列表批量落盤。自己查 yt-dlp 參數、拼 FFmpeg 命令、處理失敗重試，會打斷對話節奏。下面介紹 SkillHub 上的 視頻下載 媒體提取 批量處理（包名 yt-dlp-toolkit，命名空間 user_a10ab3ad）：把「命令行視頻下載、千站資源獲取與格式轉換」寫成 Agent 可遵循的 Skill 文檔，讓模型在合適場景下按統一流程調用底層工具，而不是每次從零摸索。

截至 2026-10-22，社區頁面 https://skillhub.cn/skills/user_a10ab3ad/yt-dlp-toolkit 提示該 Skill 已不存在或已下線；安裝接口對同一命名空間返回「未找到」。下文功能與數據以任務線索與當前可訪問頁面爲準；若你本地能安裝成功，以你環境中的 SKILL.md 爲準。

這是什麼¶

視頻下載 媒體提取 批量處理 是發佈在 SkillHub 的一類 Agent Skill，官方入口爲：

https://api.skillhub.cn/user_a10ab3ad/yt-dlp-toolkit

一句話定位（來自 Skill 簡介）：命令行視頻下載工具，支持千站資源獲取與格式轉換。名稱中的「媒體提取」「批量處理」對應典型用法——從鏈接抓取音視頻、按需轉封裝或抽軌，以及對多條 URL 或列表類資源做批處理；具體命令與邊界以包內 SKILL.md 爲準。

在 SkillHub 社區側，該條目歸類爲 design-media；展示數據爲評分 99632、下載 541 次（來源：Skill 線索，與社區榜單字段一致）。

核心功能¶

結合簡介與 Skill 命名，可確認的能力方向如下（不展開未在資料中出現的站點清單或版本號）：

1. 視頻下載：面向公開鏈接，通過命令行下載工具拉取媒體文件到本地。
2. 媒體提取：在下載流程中支持從視頻中提取音軌等衍生文件，並配合格式轉換（簡介中的「格式轉換」）。
3. 批量處理：適合「多鏈接、播放列表或任務隊列」類需求，由 Agent 按 Skill 約定組織多次調用，而不是手工重複敲命令。
4. 千站資源獲取：依賴底層下載器對多站點提取器的支持；具體站點以工具上游文檔爲準，Skill 負責在 Agent 側約束用法與排錯話術。

Skill 本身不託管視頻內容，實際下載發生在用戶本機或 Agent 可執行的 shell 環境中。

安裝與啓用¶

Skill 遵循 SkillHub 通用的 SKILL.md 包格式。安裝前建議先確認本機已有 SkillHub CLI（見 SkillHub 安裝說明）。

1、安裝 CLI（若尚未安裝）¶

command -v skillhub && skillhub --version

未安裝時可執行：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2、安裝 Skill 到當前 Agent 的 skills 目錄¶

SkillHub 要求用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。常用路徑如下（摘自官方安裝文檔）：

命令行安裝示例（命名空間與 slug 與官方 URL 一致）：

skillhub install yt-dlp-toolkit --namespace user_a10ab3ad --dir ~/.cursor/skills/

也可將下面提示詞發給 Agent，讓其按 SkillHub 規範拉取（安裝文檔鏈接爲社區通用流程）：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_a10ab3ad/yt-dlp-toolkit`。

現狀說明：在 2026-10-22 使用 skillhub install yt-dlp-toolkit --namespace user_a10ab3ad 會得到 community skill not found；訪問 https://skillhub.cn/skills/user_a10ab3ad/yt-dlp-toolkit 亦顯示 Skill 未找到。若安裝失敗，需要在 SkillHub 搜索同名或相近的 yt-dlp-toolkit，或等待作者重新上架後再裝。

3、啓用與刷新¶

安裝完成後，按你所用客戶端說明加載 skills（部分環境需重啓 IDE 或重新打開會話）。觸發詞與詳細流程以包內 SKILL.md 的 description 與正文爲準。

典型用法¶

在 Skill 可正常安裝的前提下，交互模式通常是：

1. 用戶提供視頻或列表 URL，並說明目標（整段視頻、僅音頻、字幕、批量等）。
2. Agent 匹配 Skill 的觸發場景，讀取 SKILL.md 中的檢查項（例如本機是否已安裝下載器與 FFmpeg）。
3. Agent 在用戶授權下於終端執行對應命令，彙報輸出路徑或錯誤信息。

因當前無法從官方包拉取完整 SKILL.md，此處不復現具體 yt-dlp 參數示例，避免與線上下架版本不一致。你可以在安裝成功後，直接讓 Agent「按 yt-dlp-toolkit Skill 下載該鏈接並說明保存位置」進行驗證。

適用場景與注意¶

適合誰

• 需要在對話裏頻繁「給鏈接 → 要本地文件」的創作者、運營或學習者。
• 已接受在本地安裝命令行下載鏈路與 FFmpeg，並願意由 Agent 代勞拼命令的場景。

限制與注意

• 合規：僅下載你有權獲取的內容，遵守目標站點服務條款與版權要求；Skill 文檔一般會強調使用者責任，勿用於未授權傳播。
• 登錄與私有內容：需要 Cookie 或會員權限的視頻，通常要額外提供憑證；Skill 不能繞過 DRM 或站點風控。
• 環境依賴：格式轉換、音視頻合併依賴 FFmpeg；網絡、代理與工具版本會影響成功率。
• 可用性：若社區條目已下線，以 SkillHub 頁面與 skillhub install 結果爲準，勿假設 user_a10ab3ad 命名空間始終可裝。

結尾¶

視頻下載 媒體提取 批量處理 把命令行側的千站下載與格式處理能力封裝成 Agent Skill，減少反覆查文檔的成本；社區側歸類 design-media，線索數據爲評分 99632、下載 541 次。官方地址：

https://api.skillhub.cn/user_a10ab3ad/yt-dlp-toolkit

安裝與目錄配置請對照 SkillHub 安裝與優先源配置；若頁面提示 Skill 不存在，先在 SkillHub 內確認條目是否恢復上架。