find-skills 安装与使用（Trae）：把 Skills.sh 变成你的“能力商店”

find-skills 安装与使用（Trae）：把 Skills.sh 变成你的"能力商店"

摘要（先看结论）

find-skills 是一个"元 skill"：它本身不直接干活，而是让你（或 Agent）能更快搜索、选择、安装其他 skill。
在 Trae 里想稳定使用，关键是把目标 skill 安装到项目的 .trae/skills/（或通过 --agent trae 让安装器自动放到 Trae 可读的目录）。
日常最常用的两条命令：
- npx skills find "<关键词>"：搜 skill
- npx skills add <仓库> --skill <skill-name> --agent trae -y：安装到 Trae

这里先科普两个概念，后文会用到：

npx：Node.js 自带的命令，用来"临时运行一个 npm 包提供的 CLI"。好处是不用全局安装，也能直接运行 skills 这个命令。
skills find：skills 这个 CLI 的子命令，会去 skills.sh 的索引里搜索 skill，并把候选结果打印出来；你再用 skills add 把选中的 skill 安装到本机/项目里。

再补一组名词对照，避免混淆：

skills.sh：一个 skill 生态的"目录/索引站点"，你可以把它理解成"技能商店的网页入口"。
skills（CLI）：命令行工具（你通过 npx skills ... 运行它），负责把"搜索/安装/更新 skill"这件事自动化。
skills find vs skills add：
- skills find：只负责搜索与列候选，不会改你的文件系统。
- skills add：负责把候选安装到本机/项目 （写入 ~/.agents/skills/ 或 .trae/skills/ 等目录，取决于你选的 scope/agent）。
find-skills（skill）：给 Agent 的"使用说明书"，教它什么时候该去运行 skills find、怎么挑候选、以及怎么用 skills add 安装。它不是 skills CLI 的替代品，而是把"找与装"的流程变成可被 Agent 复用的能力。

1. 背景：为什么需要 find-skills

当你希望 Trae 的能力"临时长出来"时（例如视频字幕转博客、生成 PPT、代码审查、写测试），你有两条路：

继续靠对话提示词硬堆（可用但不稳定，且难复用）
把成熟流程封装成 skill，并像装依赖一样安装（可复用、可升级、可管理）

find-skills 解决的是第二条路里的第一个难点："去哪里找合适的 skill，以及怎么装"。

2. 先确认环境：你需要什么

macOS / Linux / Windows（Windows 推荐 WSL）
Node.js（带 npm / npx）

验证：

bash 复制代码

node -v
npx -v

3. 安装 find-skills

用 Skills CLI 安装（仓库来源以你实际选择为准，下面以常见仓库为例）：

bash 复制代码

npx skills add https://github.com/vercel-labs/skills --skill find-skills

安装过程中你会看到交互式选择：

Installation scope
- Global：装到用户级目录（适合多项目共用）
- Project：装到当前项目（适合需要提交到仓库、多人共用）
Installation method
- Symlink（推荐）：只存一份，其他地方用软链接指过去，后续更新更省事
- Copy：复制多份，更新时容易不同步

建议：

想"全局可用"：选 Global + Symlink
想"团队共用、可提交"：选 Project + Copy（或 Project + Symlink，但注意链接在别的机器上不可用）

4. Trae 的关键点：如何让 skill 真正"被 Trae 用到"

Trae 通常读取项目内的 .trae/skills/<name>/SKILL.md。

所以"装上了"不等于"Trae 会用"，你需要满足其中一种：

方式 A（推荐） ：安装时直接指定 agent 为 Trae
- 让安装器把 skill 放到 Trae 可识别的位置，并做必要的链接
方式 B ：先装到 ~/.agents/skills/，再手动链接/复制进 .trae/skills/

4.1 方式 A：一条命令装到 Trae

bash 复制代码

npx skills add <owner/repo> --skill <skill-name> --agent trae -y

举例（安装一个"内容改写/一稿多发"类 skill）：

bash 复制代码

npx skills add inference-sh-7/skills --skill content-repurposing --agent trae -y

4.2 方式 B：把全局 skills 引入当前项目

如果你已经全局安装到了 ~/.agents/skills/<skill-name>，可以只把你需要的那个 skill 引入项目：

bash 复制代码

ln -s ~/.agents/skills/<skill-name> ./.trae/skills/<skill-name>

不建议把整个 ~/.agents/skills 目录整体链接进项目，会把项目技能集搞得不可控且不可移植。

5. 搜索与安装：日常工作流

5.1 先搜：找到 3 个候选

bash 复制代码

npx skills find "video transcript blog"

技巧：

关键词越具体越好：youtube transcript 比 video 更容易命中
不确定英文怎么写就用中文试试（部分仓库支持中文关键词，但英文更稳）

5.2 再装：把你选中的 skill 装到 Trae

bash 复制代码

npx skills add <owner/repo> --skill <skill-name> --agent trae -y

5.3 验证：Trae 是否能看到

bash 复制代码

npx skills list

你应该能看到类似输出：

skill 名称
路径（.trae/skills/... 或 .agents/skills/...）
Agents: Trae（说明安装器已为 Trae 做了映射）

6. 在 Trae 里怎么"自然对话触发"

实践上，触发成功率更高的写法是：明确说"搜索/安装 skill"，并把你的目标说清楚。

示例：

搜索 skill：把技术科普视频字幕改写成面向小白的结构化 Markdown 文章（含摘要/概念解释/类比/自检问答），列出 3 个候选并说明差异，然后帮我安装最合适的那个。

装完之后再说：

使用刚安装的 skill 处理以下字幕：......（粘贴字幕）

7. 安全与风险提示（很重要）

Skills 的本质是"给 Agent 加能力"，而能力通常意味着：

允许它运行命令行
允许它读写文件
允许它访问网络（取决于 skill）

建议你养成两个习惯：

安装后先打开 SKILL.md 看一眼它允许哪些工具、会执行哪些命令
不要把 API key/账号密码写进 skill 或日志

8. 自检问答（是否已经用顺了）

find-skills 是干什么的？答：它是"元 skill"，用于搜索与安装其他 skill，本身不直接完成业务任务。
为什么"装了"不等于"Trae 能用"？答：Trae 主要读 .trae/skills/；如果 skill 只装在全局目录且 Trae 不读取，就不会被调用。
最常用的两条命令是什么？答：npx skills find "<query>" 搜索；npx skills add <repo> --skill <name> --agent trae -y 安装到 Trae。