初始发布: 21 个 skills (Claude Code / Codex / DSH)

2026-08-14 01:51:44 +08:00
commit ea0857bedb
129 changed files with 35566 additions and 0 deletions
@@ -0,0 +1,50 @@
+# 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
+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
+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）。