skills/youtube-download/README.md

youtube-download — 便携技能包

把 YouTube 视频下成本地最高画质 MP4（最高 4K，内含最佳音质 Opus 音轨）。默认规格：只下视频版，不单独下音频；除非用户明确要求音频版。已处理好现代 yt-dlp 下 YouTube 的两个坑：JS 运行时 + 机器人检测 cookie。

目录

youtube-download/
├─ SKILL.md              # 技能说明（给 AI agent 读的：何时用、怎么用、坑）
├─ README.md            # 本文件
└─ scripts/
   ├─ yt-download.ps1    # Windows 一键脚本（自动装 yt-dlp/deno）
   └─ yt-download.sh     # Linux/macOS 一键脚本

快速开始

Windows

powershell -ExecutionPolicy Bypass -File scripts\yt-download.ps1 "https://www.youtube.com/watch?v=VIDEO_ID"

首次运行会自动把 yt-dlp.exe 和 deno.exe 下到 scripts\bin\。还需要系统装了 ffmpeg（winget install Gyan.FFmpeg）。

Linux/macOS

bash scripts/yt-download.sh "https://www.youtube.com/watch?v=VIDEO_ID"

需先装 yt-dlp、ffmpeg、以及 JS 运行时 bun / deno / node 任一（命令见 SKILL.md 顶部；脚本默认优先用 bun）。

登录/受限视频要 cookie

公开视频不用管。如果报 Sign in to confirm you're not a bot：

1. 浏览器（已登录 YouTube）装扩展 Get cookies.txt LOCALLY。
2. 打开着 youtube.com 标签页，点扩展 → Export，得到 Netscape 格式 cookie 文件。
3. 改名为 cookies.txt 放进 scripts/ 目录（脚本会自动带上）。
4. 报“cookies no longer valid”时重新导出覆盖即可。

⚠️ cookie 是你的登录凭证，别外发、别提交到 git。本包不含 cookie。

在 Codex / 其他 agent 里用

Codex（OpenAI CLI）没有 Claude 那种正式 skill 装载机制，但这个包是纯文档 + 脚本，任何 agent 都能用：

• 把整个 youtube-download/ 文件夹放进项目，或放到 Codex 能读到的位置。
• 在项目根的 AGENTS.md 里加一句指路，例如：

  需要下载 YouTube 视频时，读 youtube-download/SKILL.md 并运行其中的脚本。

• 或直接让 Codex “按 youtube-download/SKILL.md 的方法下这个链接”。

如果目标是 Claude Code / Claude Agent：把 youtube-download/ 整个放进 ~/.claude/skills/（或项目的 .claude/skills/）即可作为技能被自动发现（靠 SKILL.md 的 frontmatter）。