前言¶
在 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 命名，可确认的能力方向如下（不展开未在资料中出现的站点清单或版本号）：
- 视频下载：面向公开链接，通过命令行下载工具拉取媒体文件到本地。
- 媒体提取：在下载流程中支持从视频中提取音轨等衍生文件，并配合格式转换（简介中的「格式转换」）。
- 批量处理：适合「多链接、播放列表或任务队列」类需求，由 Agent 按 Skill 约定组织多次调用，而不是手工重复敲命令。
- 千站资源获取：依赖底层下载器对多站点提取器的支持；具体站点以工具上游文档为准，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/ 可能不会被识别。常用路径如下（摘自官方安装文档）：
| Agent / 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/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 可正常安装的前提下，交互模式通常是：
- 用户提供视频或列表 URL，并说明目标（整段视频、仅音频、字幕、批量等）。
- Agent 匹配 Skill 的触发场景，读取
SKILL.md中的检查项（例如本机是否已安装下载器与 FFmpeg）。 - 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 内确认条目是否恢复上架。
