用途:在动手编写新技能前,先搜索、下载并检查 playbooks.com 上的既有 AI 编程技能,用于对比、取证或建立技能语料库。触发边界:适合搜索主题相关技能、批量下载对比、构建基于证据的语料、把搜索结果直接管道到批量下载、检查语料以决定可继承或应避免的做法。不适用于编写新技能(用 build-skills)、测试技能教学质量和与技能发现无关的普通网络研究。
前提:先验证安装,运行 skill-dl --version。缺失时用已保存并检查过的安装脚本安装,命令为 curl -fsSL https://raw.githubusercontent.com/yigitkonur/cli-skill-downloader/main/install.sh -o /tmp/install-skill-dl.sh,再 sed -n '1,160p' 检查后执行 bash /tmp/install-skill-dl.sh;macOS 若 bash --version 为 3.x,需先 brew install bash,再用 "$(brew --prefix)"/bin/bash 运行。安装需要 git 加 curl 或 wget,正常搜索内置后端默认值,无需 API 密钥。
主要用法:先用 3-20 个空格分隔的关键词搜索,如 skill-dl search typescript mcp server sdk patterns --top 20,可用 --top N 限制结果、--min-match N 过滤匹配数。随后按匹配数、范围契合度、多样性、作者/仓库顺序筛选 3-10 个 URL,可存成每行一个的 URL 文件。单条下载用 skill-dl <URL> -o ./corpus;批量用 skill-dl urls.txt -o ./corpus --no-auto-category -f;可管道搜索到下载,大批量先 --dry-run。默认输出到 <output>/<auto-category>/<owner>--<repo>--<skill>/,加 --no-auto-category 可扁平化。下载后用 tree、find 等命令统计并逐个阅读 SKILL.md 及 references。
限制:搜索关键词不得少于 3 个、不得超过 20 个;超过 20 个 URL 的批量不得跳过 dry run;下载失败可用 -v 排查。下载的技能应作为对比证据,不可当作可复制模板。若 skill-dl 无法安装,只能手动到 GitHub 搜索含 SKILL.md 的仓库。更多细节见 references/search-strategies.md、download-patterns.md、corpus-inspection.md。