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

1. 为什么你的 Trae 需要一个“能力商店”如果你已经在用 Trae 写代码、改文档、做自动化大概率遇到过这种尴尬每次想让 Agent 干点“稍微专业一点”的活比如把一段视频字幕整理成结构化博客、给一个模块补单元测试、或者按团队规范做代码审查都得在对话框里重新描述一遍需求。描述得不够细结果就飘描述得太细每次都要复制粘贴一大段提示词累且容易漏。find-skills就是来解决这个问题的。它本身不直接干活而是一个“元 skill”——你可以把它理解成 Trae 里的“应用商店入口”。它教会 Agent 一件事当用户提出某个能力需求时先去skills.sh这个技能索引站点搜索有没有现成的 skill列出候选再通过npx skills add把选中的 skill 安装到项目里。装好之后这个 skill 就变成了 Trae 可以反复调用的“本地能力”。适合谁用三类人最明显一是经常用 Trae 做重复性内容加工的人比如把会议记录转成周报、把长文拆成推文二是团队里想统一 Agent 行为规范的人把审查规则、提交信息格式封装成 skill 共享三是喜欢折腾 Agent 工作流、想把“提示词”升级成“可管理依赖”的开发者。这篇就按“先装 find-skills再用它逛商店、装 skill、验证 Trae 能读到”的顺序走一遍命令都可以直接复制。2. 前置准备Node.js、npx 与 Trae 的目录约定在装任何 skill 之前先把环境确认清楚。find-skills和整个 Skills CLI 都依赖 Node.js 生态所以你需要本机有 Node.js自带 npm 和 npx。macOS、Linux 直接装Windows 建议用 WSL因为后续的软链接操作在 WSL 里更顺Trae 读取项目目录也更稳定。验证命令很简单打开终端跑node -v npx -v只要两个都能打印出版本号比如v20.x和10.x环境就 OK。如果npx -v报错说明 npm 没装好先补 Node.js。这里要分清三个容易混的东西。skills.sh是一个网页端的技能索引站点相当于商店的“货架”skills是通过npx临时运行的命令行工具负责搜索和安装find-skills则是一个具体的 skill它的作用是让 Agent 学会“什么时候去调skills find、怎么挑候选、怎么用skills add装进 Trae”。三者关系是find-skills 指挥 AgentAgent 调用 skills CLICLI 去 skills.sh 取货。还有一个关键约定Trae 通常读取项目内的.trae/skills/name/SKILL.md。也就是说skill 装到全局目录不等于 Trae 会用必须让它出现在 Trae 能读到的位置。这一点后面会专门处理。3. 安装 find-skills一条命令 两个交互选择装 find-skills 本身用 Skills CLI 完成。仓库来源以你实际选用的为准下面用常见仓库举例npx skills add https://github.com/vercel-labs/skills --skill find-skills执行后会出现交互式选择主要两项第一项是 Installation scope。Global 表示装到用户级目录适合多个项目共用Project 表示装到当前项目适合提交到仓库、团队共享。我的建议是如果你只是自己用选 Global如果这个 skill 要跟着项目走、让同事拉下来就能用选 Project。第二项是 Installation method。Symlink 只存一份其他地方用软链接指过去后续更新省事Copy 会复制多份更新时容易不同步。个人使用推荐 Symlink团队项目如果担心软链接在别人机器上失效可以选 Copy。装完后可以用npx skills list看一眼确认 find-skills 已经出现在列表里。这一步只是把“元 skill”装好真正让它对 Trae 生效还要看下一节的目录映射。4. 可复制配置让 Trae 真正读到 skillTrae 读取的是项目内的.trae/skills/。所以“装上了”和“Trae 会用”是两件事。有两种方式让它们对齐。方式 A 最省事安装时直接指定 agent 为 trae让安装器把 skill 放到 Trae 可识别的位置。命令骨架如下npx skills add owner/repo --skill skill-name --agent trae -y举个例子安装一个内容改写类的 skillnpx skills add inference-sh-7/skills --skill content-repurposing --agent trae -y--agent trae是关键参数-y表示跳过确认直接装。装完后检查项目根目录下是否出现了.trae/skills/content-repurposing/SKILL.md。方式 B 适合你已经全局装过、只想把某一个 skill 引进当前项目的情况。假设全局目录在~/.agents/skills/skill-name用软链接引入mkdir -p ./.trae/skills ln -s ~/.agents/skills/skill-name ./.trae/skills/skill-name注意不要图省事把整个~/.agents/skills目录整体链接进项目那样项目技能集不可控换台机器就崩。只链你需要的那一个。如果你希望用配置文件的方式管理可以在项目里维护一个config.toml骨架把常用 skill 的来源和 agent 记下来方便团队同步# .trae/skills-config.toml [skills.find-skills] repo https://github.com/vercel-labs/skills skill find-skills agent trae [skills.content-repurposing] repo inference-sh-7/skills skill content-repurposing agent trae这个文件不是 Trae 强制要求的但作为“能力清单”很好用新人拉下项目后照着它逐条跑npx skills add就能把环境补齐。5. 验证请求搜索、安装、确认 Trae 可见装好 find-skills 后日常最常用的两条命令就是搜索和安装。先搜npx skills find video transcript blogskills find只负责搜索和列候选不会改你的文件系统。关键词越具体命中率越高比如youtube transcript比video好不确定英文怎么写可以试中文但英文通常更稳。输出里会列出候选 skill 的名称、来源仓库和简介你从中挑一个。挑好后安装到 Traenpx skills add owner/repo --skill skill-name --agent trae -y装完再验证一次npx skills list理想输出里应该能看到 skill 名称、路径.trae/skills/...或.agents/skills/...以及Agents: Trae这样的标记说明安装器已经为 Trae 做了映射。如果路径是.trae/skills/开头基本就稳了。最后在 Trae 里做一次自然对话触发。触发成功率更高的写法是明确说“搜索/安装 skill”并把目标讲清楚。比如搜索 skill把技术科普视频字幕改写成面向小白的结构化 Markdown 文章含摘要、概念解释、类比和自检问答。列出 3 个候选并说明差异然后帮我安装最合适的那个。装完之后再说使用刚安装的 skill 处理以下字幕……粘贴字幕如果 Trae 能正确调用并产出结构化结果说明整条链路通了。6. 本篇常见错排查报错npx: command not foundNode.js 没装或没进 PATH。重装 Node.js确认node -v和npx -v都能输出。skills add装完Trae 里却调不到最常见原因是装到了全局目录而 Trae 只读项目内.trae/skills/。用方式 A 加--agent trae重装或按方式 B 手动软链接进项目。软链接在同事机器上失效Symlink 指向的是你本机的绝对路径换机器就断。团队共享场景改用 Copy或者让大家各自跑一遍npx skills add。skills find搜不到想要的结果关键词太宽泛。把需求拆成“对象 动作 输出格式”比如markdown table converter比convert精准得多。安装时卡在交互选择加-y跳过确认或在交互里明确选 Global/Project 与 Symlink/Copy。CI 环境里必须加-y。安全提醒skill 本质是给 Agent 加能力可能涉及运行命令、读写文件、访问网络。装完先打开SKILL.md看一眼它允许哪些工具、会执行哪些命令不要把 API key、账号密码写进 skill 或日志里。如果你在接入过程中需要统一管理模型调用和密钥可以走 TaoToken 的 API Keys 页面生成密钥再对照接入文档把 base_url 配到你的客户端里想先验证模型通不通直接用模型对话页面发一条测试请求最直观。长期在 Trae 里跑编码和 Agent 任务的话Coding Plan 的额度模型更适合高频调用场景。# 完整流程速查 node -v npx -v npx skills add https://github.com/vercel-labs/skills --skill find-skills npx skills find video transcript blog npx skills add owner/repo --skill skill-name --agent trae -y npx skills list把这几条跑顺你的 Trae 就算真正接上了 Skills.sh 这个“能力商店”。后面每遇到一个重复需求先想“有没有现成 skill”而不是“再写一段提示词”效率差距会越拉越大。