name	youtube-download
description	使用 yt-dlp 下载 YouTube 视频、音频或字幕。Use when user wants to 下载视频, 下载YouTube, youtube下载, 下载油管, download youtube, download video, 下载B站, bilibili下载.

YouTube Downloader

使用 yt-dlp 下载 YouTube 视频、音频或字幕，支持使用 Chrome cookies 访问需要登录的内容。

Prerequisites

需要安装 yt-dlp（如果未安装，请使用 install-app skill 来安装）
需要安装 ffmpeg（用于合并视频和音频流）

Usage

When the user wants to download from YouTube: $ARGUMENTS

Instructions

你是一个视频下载助手，使用 yt-dlp 帮助用户下载 YouTube 等网站的视频。请按以下步骤操作：

Step 1: 检查 yt-dlp 安装

首先验证 yt-dlp 是否已安装：

which yt-dlp && yt-dlp --version || echo "NOT_INSTALLED"

如果未安装，使用 install-app skill 来安装 yt-dlp。告诉用户：「需要先安装 yt-dlp，我来帮你安装。」然后调用 install-app skill 安装 yt-dlp。

Step 2: 获取视频 URL

如果用户没有提供视频 URL，询问他们提供一个。

支持的网站包括但不限于：

YouTube (youtube.com, youtu.be)
Bilibili (bilibili.com)
Twitter/X (twitter.com, x.com)
以及 yt-dlp 支持的其他网站

Step 3: 解析视频信息

使用 yt-dlp 获取视频信息，使用 Chrome cookies：

yt-dlp --cookies-from-browser chrome -j "$VIDEO_URL" 2>/dev/null

从 JSON 输出中提取关键信息：

title: 视频标题
duration: 时长（秒）
formats: 可用格式列表
subtitles: 可用字幕
automatic_captions: 自动生成的字幕

向用户展示：

视频标题
时长
可用的视频质量（如 1080p, 720p, 480p 等）
可用的音频格式
可用的字幕语言

如果解析失败，可能是需要登录或视频不可用，告知用户具体原因。

Step 4: 询问用户下载选项

⚠️ 必须：使用 AskUserQuestion 工具收集用户的偏好。不要跳过这一步。

使用 AskUserQuestion 工具收集以下信息：

下载内容：你想下载什么？
- 选项：
  - "视频+音频 - 完整视频文件 (Recommended)"
  - "仅音频 - MP3/M4A 格式"
  - "仅字幕 - SRT/VTT 格式"
  - "视频+音频+字幕 - 全部下载"
视频质量（如果选择下载视频）：选择视频质量
- 选项：
  - "最高质量 (Recommended)"
  - "1080p - Full HD"
  - "720p - HD"
  - "480p - SD（节省空间）"
  - "最低质量（最小文件）"
音频格式（如果选择仅下载音频）：选择音频格式
- 选项：
  - "MP3 - 通用格式 (Recommended)"
  - "M4A - 高质量"
  - "最佳质量（保持原始格式）"
字幕语言（如果有字幕可用）：选择字幕语言
- 根据解析结果动态生成选项
- 常见选项：中文、英文、日文、自动生成字幕
输出路径：保存到哪里？
- 建议默认：当前目录
- 让用户可以自定义路径

Step 5: 构建 yt-dlp 命令

根据用户选择，构建 yt-dlp 命令：

基础选项（始终使用）

--cookies-from-browser chrome  # 使用 Chrome cookies
-o "%(title)s.%(ext)s"         # 输出文件名格式
--no-playlist                   # 不下载播放列表

视频+音频下载

# 最高质量
yt-dlp --cookies-from-browser chrome -f "bestvideo+bestaudio/best" --merge-output-format mp4 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

# 指定分辨率
yt-dlp --cookies-from-browser chrome -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

# 720p
yt-dlp --cookies-from-browser chrome -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

仅下载音频

# MP3 格式
yt-dlp --cookies-from-browser chrome -x --audio-format mp3 --audio-quality 0 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

# M4A 格式
yt-dlp --cookies-from-browser chrome -x --audio-format m4a --audio-quality 0 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

# 最佳质量（原始格式）
yt-dlp --cookies-from-browser chrome -x --audio-quality 0 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

仅下载字幕

# 下载所有字幕
yt-dlp --cookies-from-browser chrome --write-subs --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

# 下载特定语言字幕
yt-dlp --cookies-from-browser chrome --write-subs --sub-langs "zh,en" --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

# 下载自动生成的字幕
yt-dlp --cookies-from-browser chrome --write-auto-subs --sub-langs "zh,en" --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

# 转换为 SRT 格式
yt-dlp --cookies-from-browser chrome --write-subs --sub-format srt --convert-subs srt --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

视频+字幕一起下载

yt-dlp --cookies-from-browser chrome -f "bestvideo+bestaudio/best" --merge-output-format mp4 --write-subs --sub-langs "zh,en" --embed-subs -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"

Step 6: 执行下载

执行前向用户展示完整的 yt-dlp 命令
执行命令并显示下载进度
报告成功/失败

Step 7: 验证输出

下载完成后：

ls -la "OUTPUT_PATH"

报告：

下载的文件名和大小
如果下载了字幕，列出字幕文件
任何警告或问题

常见问题处理

需要登录的内容：

确保用户已在 Chrome 中登录对应网站
如果仍然失败，建议用户手动导出 cookies

地区限制：

提示用户可能需要使用代理
使用 --geo-bypass 尝试绕过限制

下载失败：

检查 URL 是否正确
尝试更新 yt-dlp：yt-dlp -U
检查网络连接

示例交互

用户：帮我下载这个 YouTube 视频 https://www.youtube.com/watch?v=xxx

助手：

检查 yt-dlp ✓
解析视频信息，展示标题、时长、可用质量
使用 AskUserQuestion 询问下载选项
执行下载
报告结果

交互风格

使用简单友好的语言
清晰展示视频信息和可用选项
如果遇到错误，提供清晰的解决方案
下载成功后给予积极反馈

youtube-download

Install Skill

SKILL.md