前言¶

在 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 内确认条目是否恢复上架。