1. 为什么我开始关注 Find Skills 这套技能体系刚接触 Agent 技能体系的开发者最容易卡在同一个地方技能包到底装在哪、Agent 怎么知道它存在、装完之后怎么确认真的被识别了。我最初也是把 Skill 当成普通的 npm 包来理解结果发现它更像是一份「给 Agent 看的说明书」——目录结构、加载路径、Agent 平台适配任何一环对不上Agent 就会当它不存在。Find Skills 是 Vercel Labs 维护的一套 Agent 技能检索与管理工具核心能力是让 Claude Code、Cursor、Gemini CLI 这类智能体通过一条命令完成技能的检索、安装和调用。它收录了 10w Skill支持开箱即用、多平台、一键安装和定向安装。适合谁适合刚上手 Agent 技能、想先在本地跑通第一个 Skill 并确认 Agent 能正确识别调用的开发者。这篇就按 CLI 与 npm 两条路径把安装、检索、验证完整走一遍。需要说明的是Find Skills 本身是技能管理工具它不替代编辑器也不直接连生产库定位就是本地技能目录的安装与同步。理解这一点后面的路径问题就顺了。2. 前置准备TaoToken 与运行环境在动手装 Skill 之前先把模型调用这一层准备好。Agent 要能跑起来得有一个稳定的模型入口。我这边用的是 TaoToken官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置时别拼错。你需要先拿到 API Key入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。拿到之后建议先做一次模型对话验证确认 Key 可用入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。这一步别跳过因为后面 Skill 加载验证时如果 Agent 调不通模型你会分不清是 Skill 没装好还是 Key 有问题。环境方面Node.js 建议 18 以上npm 随 Node 一起装好即可。检查一下node -v npm -v两条命令都能正常输出版本号就可以继续。如果 npm 全局目录没有写权限全局安装那一步会报 EACCES这个后面排障章节会讲。3. 两条安装路径npx 临时用与 npm 全局装Find Skills 支持临时使用和全局安装两种方式区别在于命令装在哪、会不会被清理。临时使用就是在 skills 命令前加 npx命令跑在临时目录适合使用频率不高的场景npx skills add vercel-labs/agent-skills全局安装用 npm装一次持续可用适合高频使用npm install skills -g装完验证一下 CLI 是否可用skills -h能打印出帮助文档说明 CLI 就位。这里有个细节全局安装后命令名是 skills不是 find-skills别记混。作用范围也分两种。项目级针对当前项目生效安装路径是 ./skills/全局级针对用户生效需要带 -g 参数路径是 ~/skills/。我建议新手先用项目级出问题好清理确认流程跑通再考虑全局。4. 可复制配置检索、安装与指定 Agent4.1 用 find 检索技能CLI 提供了交互式搜索命令格式是 skills find 加关键词。以 ui-ux-pro-max 为例skills find ui-ux-pro-max它会从 skills.sh 的收录信息里检索相关 Skill 并输出。注意输出的链接是 Skill 在 skills.sh 的收录页不是仓库地址。你可以点开看完整安装命令也可以按仓库名自己补全 GitHub 地址格式是 https://github.com/Skill名称 或加 .git 后缀。4.2 先看仓库里有哪些技能安装前建议先列一下仓库提供的技能用 --list 参数只列不装skills add nextlevelbuilder/ui-ux-pro-max-skill --list简写仓库名、完整 GitHub 地址、带 .git 的地址三种写法都支持skills add nextlevelbuilder/ui-ux-pro-max-skill --list skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill --list skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git --list执行后会列出当前仓库所有技能确认你要装的那个在里面再往下走。4.3 通用安装与指定参数安装通用安装直接跑skills add nextlevelbuilder/ui-ux-pro-max-skill它会走可视化流程上下键切换 Skill空格键选择回车下一步然后选 Agent 平台、选作用范围Project 或 Global、选安装方式Symlink 推荐或 Copy to all agents最后 Yes 确认。如果你不想走交互用参数直接指定。指定 Agent 平台skills add nextlevelbuilder/ui-ux-pro-max-skill --agent claude-code skills add nextlevelbuilder/ui-ux-pro-max-skill --agent claude-code -g再指定具体 Skill 名称skills add nextlevelbuilder/ui-ux-pro-max-skill --skill ui-ux-pro-max --agent claude-code skills add nextlevelbuilder/ui-ux-pro-max-skill --skill ui-ux-pro-max --agent claude-code -g参数给全之后就不会再弹选择项了。常用参数对照如下参数作用-g, --global装到全局用户级-a, --agent指定 Agent*通配所有-s, --skill指定技能名*通配所有-l, --list只列不装-y, --yes跳过确认--copy复制文件而非软链接--all等价于 --skill --agent -y--jsonJSON 输出机器可读有个点要提醒用通用安装方式时通用配置总会被装一份到 .agents/skills 目录无论你装的是项目级还是全局级。支持从 .agents/skills 加载的 Agent 包括 Amp、Cline、Codex、Cursor、Gemini CLI、GitHub Copilot、Kimi Code CLI、OpenCode、Warp 等需要额外配置的包括 Claude Code.claude/skills、Augment.augment/skills、CodeBuddy.codebuddy/skills等。装之前先确认你的 Agent 属于哪一类。5. 验证请求确认 Agent 真的识别了 Skill装完不等于生效得验证。分两步。第一步查已安装列表skills list默认查项目下的 Skill查全局加 -gskills list -g列表里能看到刚装的技能名说明文件落盘了。第二步让 Agent 实际调用一次。以 Claude Code 为例重启会话后在对话里直接提一个该 Skill 覆盖的任务观察它是否引用技能内容。如果 Agent 完全没反应多半是加载路径不对——Claude Code 只认 .claude/skills你装到 .agents/skills 它就读不到这时候用 --agent claude-code 重装一次。模型侧也要确认通。用 TaoToken 的模型对话入口发一条测试请求确认返回正常入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。模型通、技能列表有、Agent 能引用三个条件同时满足才算真正跑通。6. 本篇常见错排查EACCES 权限报错全局安装时 npm 目录没写权限。别用 sudo 硬装改 npm 全局目录到用户目录更干净npm config set prefix ~/.npm-global export PATH~/.npm-global/bin:$PATHskills 命令找不到全局装完但 PATH 没更新重开终端或手动加 PATH。Agent 读不到技能最常见就是路径不匹配。通用配置走 .agents/skillsClaude Code 走 .claude/skills装错目录等于没装。用 skills list 确认实际落盘位置再对照 Agent 的加载目录。软链接失效Symlink 方式在跨盘或移动目录后容易断改用 --copy 复制文件更稳。误删想恢复项目级 Skill 可以用 experimental_install 从 skills-lock.json 恢复skills experimental_install这个命令只对项目 Skill 生效全局的不行。原理是安装时在项目根目录写了 skills-lock.json 记录安装信息恢复时按记录重装。想自己建技能用 init 命令名称最好带目录否则会在工作区根目录创建skills init .codex/skills/my-skills会生成一个空的 Skill 结构往里填内容即可。7. 下一步把技能管理接进日常流程跑通第一个 Skill 之后日常维护主要靠几条命令skills check 检查更新skills update 全量升级skills remove 加技能名移除全局的记得带 -g。更新和移除都建议先 list 确认当前状态避免误操作。如果你打算长期做编码类 Agent 任务可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 配合技能体系用起来更顺。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置细节都在里面。Claude Code 相关的接入说明在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 。最后留一个我踩过的坑别一上来就装一堆技能先装一个、验证一个、再用一个确认 Agent 的加载路径和调用行为符合预期再批量铺开。技能目录乱了之后排查成本比重新装高得多。