如果说 Claude Code、Cursor 这些 AI 代理像一套新操作系统，那 skills 就是装在上面的应用，而 find-skills，就是那只「全局搜索框」。

---

一、背景：技能越来越多，「发现」反而成了最大的问题

1.1 从一个 PR 审查需求说起

一个很典型的场景：要做 PR 审查自动化。
常规路线你肯定不陌生：

• 翻 GitHub 仓库
• 看各种 README、示例
• 对着模糊的搜索结果一个个点进去筛选

折腾半天差点放弃，直到同事说了一句：你用下 find-skills 试试。

结果是一条命令搜索下来，不只找到了合适的 PR 审查技能，还顺带挖出几个意外好用的工具。这个体验直接「转粉」。

1.2 AI 代理好用，前提是你装对「技能」

现在主流 AI 编程助手（Claude Code、Cursor 等）都在往「Agent + Skills」方向走：核心模型负责理解和推理，具体能力靠一堆 Skill 扩展。

但有两个现实问题：

• 技能数量爆炸：从代码审查到部署、从 changelog 到品牌分析，应有尽有。
• 分散在不同仓库：vercel-labs、Composio 等各自维护自己的技能集合。

没有统一入口的时候，「我知道有东西，但我找不到」变成了最大痛点。find-skills 的价值就在于：只管搜，别管在哪。

---

二、Skills / skills.sh / find-skills

2.1 Skills：AI 代理的「应用」

• Skills 是模块化的 Agent 扩展包
• 对象是各种 AI 代理（比如 Claude Code、Cursor）
• 每个 Skill 做一类具体活：代码审查、文档生成、数据分析、部署自动化等

可以把它理解成：

-「模型」负责脑子
-「技能」负责手脚

模型不会凭空长出 CI/CD 能力，但装上对应 Skill，立刻就能用一套比较成熟的工作流了。

2.2 skills.sh：官方「应用商店」

skills.sh 在生态里更像是一个「官方商店」：提供技能列表、排名、下载量、更新频率、使用场景等信息。

能在上面做的事主要有：

• 按分类或关键词浏览技能
• 看哪些技能热度高、更新勤快
• 找到技能的安装方式和说明

但问题在于：你总不能每次都开浏览器手动搜。

2.3 find-skills：商店里的「搜索栏」，而且是命令行版

find-skills 的定位非常明确：「发现和安装 skills 的工具，它自己不创造技能，只帮你找到技能。」

从生态数据上看，它已经成为事实上的「跨平台标准工具」：

• 每周 94.1K 装机量，远超第二名好几倍
• 不同平台上都大量存在：
  • claude-code：89.8K（95.5%）
  • opencode：87.3K（92.8%）
  • codex：85.5K（90.9%）
  • cursor：83.8K（89.1%）

这组数字说明两个事：

• 用 AI 代理的人，绝大多数都会顺带装上 find-skills
• 它已经是「不装有点不方便」的那种基础工具

---

三、find-skills 的能力边界：它不帮你写代码，但帮你找到能写的那一个

3.1 三个核心特性

• 智能搜索：按关键词快速匹配相关技能
• 交互式选择：给你一个可选列表，而不是只吐一堆链接
• 多平台支持：不局限于单一 Agent，技能可以被不同工具复用

关键点在于，它做得足够「窄」：

• 不尝试做复杂工作流编排
• 不往 IDE 里塞一堆 UI
• 就只做一件事：帮你把「我需要什么」翻译成「装哪个 Skill」

3.2 四个实际会用到的命令

核心命令只有四个：

npx skills find [query]   # 搜索技能
npx skills add            # 安装技能
npx skills check          # 检查更新
npx skills update         # 更新所有技能

list、remove 这些不算「高频」，因为你日常真正常用的就这四个：

• 找
• 装
• 查更新
• 一键全更

从使用体验的角度，这种刻意「少而精」的命令设计反而更利于被融入日常工作流。

---

四、典型使用场景：什么时候应该想起 find-skills？

4.1 场景 1：用户问「如何做 X」

例如你问：

How do I make my React app faster?

find-skills 会自动去搜性能优化相关技能，比如：vercel-react-best-practices。

这里的价值是：

• 你不用自己想「有没有 React 优化相关的技能」
• 问题本身就可以触发技能搜索

4.2 场景 2：直接问「帮我找 X 的 skill」

比如：

find a skill for PR review

它会直接给出 PR 审查相关技能列表，让你选装。

这类语句在团队里很常见，尤其是大家已经习惯 skill 生态之后。

4.3 场景 3：问「你能不能做 X」

比如：

Can you help me with testing?

find-skills 会从技能层面给出「能」，并顺带告诉你「靠的是哪几个技能」。

这在需求沟通中非常有用：可以很快识别现有生态里有没有现成方案，不用拍脑袋。

4.4 场景 4：觉得现有能力不够用，想扩展

当你感觉：

• 代码能写，但部署全靠人
• 可以帮你改 bug，但不能跑完整测试
• 能生成文档，但不能生成 changelog

此时就可以用 find-skills 搜「deployment」「ci-cd」「testing」「changelog」这类关键词，补上短板。

4.5 场景 5：当成工具 / 模板 / 工作流搜索入口

例如：

• 搜索「deployment」找部署工具
• 搜索「ci-cd」找流水线相关技能
• 搜索「template」「workflow」挖项目模板或标准流程

这类需求在项目初期尤其高频，可以帮你快速搭出「能跑的脚手架」。

4.6 场景 6：特定领域的专业辅助

• 设计
• 测试
• 部署
• 以及其他垂直业务领域

前 3 个场景（如何做 X / 找 X 的技能 / 能否做 X）用得最频繁，几乎是日更级别。

---

五、安装与配置：从「能跑」到「团队可复用」

5.1 环境准备

要求很简单：

• 需要 Node.js
• 官方建议 Node.js 16+（现在大部分人机器上都满足）

如果没有，去 nodejs.org 下个 LTS 版本即可。

5.2 一行命令安装

标准安装方式：

npx skills add vercel-labs/agent-skills@find-skills

执行这行之后：

• 如果在项目目录执行 → 安装到 ./skills/，方便和仓库一起提交
• 如果加上 -g 参数 → 安装到 ~/skills/，所有项目都能用

比如全局装：

npx skills add vercel-labs/agent-skills@find-skills -g

5.3 验证是否安装成功

很简单：

npx skills find

如果看到交互式搜索界面，就说明已经就绪，可以正常用。常见问题主要有两类：

• GitHub 访问问题（网络不通、被限流等）
• Node.js 版本太低

解决方式也比较直接：检查网络、升级 Node.js。

---

六、三个真实案例：找到合适技能之后，能具体帮你省多少事？

三个案例，都是开发团队日常会遇到的场景。

6.1 案例一：React 性能优化

诉求：React 应用首屏加载很慢，希望能有系统化的优化建议。操作是：

npx skills find react performance

find-skills 返回一个典型候选：

• vercel-react-best-practices
• 对应链接：https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices

这个技能大致提供：

• 超过 40 条优化规则
• 覆盖 8 个类别（例如瀑布流请求、包体积优化、服务端性能、缓存策略等）

安装之后，搭配 Claude Code 使用，可以让 AI 代理按照这些规则主动审查你的 React 代码，给出具象的改进建议。

• 首屏加载时间从 3.2 秒降到 1.8 秒，
• 对于前端项目，这是用户能明显感知的变化。

6.2 案例二：PR 审查自动化

场景：团队每天几十个 PR，纯手工审查非常费精力。操作命令：

npx skills find pr review

典型返回包括（简化后）：

• wshobson/agents/test-driven-development@test-driven-development
• vercel-labs/agent-skills@review-implementing

一个偏测试驱动开发工作流，一个偏 PR 审查自动化，你可以按团队风格选择适合的装上。

效果上：

• 以前一个 PR 要看 30 分钟
• 现在有了自动检查 + 人工确认，大约 10 分钟能搞定

这种量级的节省，对大团队的累计效应非常可观。

6.3 案例三：自动生成 changelog

需求：每发版都要写 changelog，手写又枯燥又容易漏。命令：

npx skills find changelog

find-skills 会返回诸如：ComposioHQ/awesome-claude-skills@changelog-generator。

功能大致包括：

• 根据 git 提交自动生成更新日志
• 支持多种格式：Markdown、JSON、HTML 等
• 按提交类型（feat、fix、docs …）分组整理

团队现在已经习惯用它来生成 changelog，发版前跑一次命令就能拿到一份可直接给产品、运营甚至用户看的更新说明。

---

七、进阶用法：如何把 find-skills 用成「长期基础设施」

7.1 搜索技巧：让每一次查询都更「准」

三点经验：

• 关键词要具体
  用「react testing」比单纯「testing」好得多；用「preview」比泛泛的「review」更精准。
• 尝试同义词
  搜不到「deploy」，可以试「deployment」「ci-cd」。不同作者描述习惯不一样。
• 组合关键词
  用「typescript async」替代单一的「typescript」或「async」，能大幅减少噪音结果。

这几点本质就是：把自然语言问题尽量收敛成带上下文的技术关键词。

7.2 技能管理习惯：避免变成「技能坟场」

三个简单但实用的建议：

• 定期检查更新
  每周跑一次：

  npx skills check
  

• 一键更新所有技能

  npx skills update
  

  同时注意看更新日志，避免踩到破坏兼容的版本。

• 定期清理不用的技能
  通过：

  npx skills list
  

  看装了什么，然后用 npx skills remove 删掉一个月都没动过的技能。

这套习惯和你管理 VS Code 插件、浏览器扩展其实是同一个思路：只留真正有用的。

7.3 生态里常见的技能类别

按经验做了一个非严格分类：

• Web 开发：React、Vue、Angular、Node.js
• 测试：单元测试、集成测试、E2E
• DevOps：部署、CI/CD、监控、日志
• 数据分析：数据清洗、可视化、统计
• 文档：Markdown、Word、PDF、PPT
• 业务：品牌分析、广告、客户研究
• 创意：设计、图像、视频编辑

这个分类更多是帮你在想不出关键词时，先锁定方向再做组合搜索。

7.4 搜不出来怎么办？

有时你就是搜不到合适的技能。 备选方案：

• 换关键词，多试几个说法
• 直接翻大仓库：
  • vercel-labs/agent-skills
  • ComposioHQ/awesome-claude-skills
• 自己写一个 Skill（SKILL.md 格式并不复杂）
• 去社区问：GitHub Issues、Discord、Reddit 等

这背后其实是一个现实判断：再好的搜索工具，也不可能替代生态本身的成熟度。找不到不一定是工具问题，很可能是生态确实还没长出来。

---

八、安全与企业视角：除了好用，还得「可控」

自动装几个后门 skill 就等死吧。

这说明，对于企业/团队而言，find-skills 只是「发现」的一环，真正要落地，还需要一层安全和治理策略，例如：

• 内部白名单：只允许使用审过的技能集合
• 私有技能仓库：把内部技能托管在受控环境，统一通过 find-skills 接入
• 审计与日志：记录哪些项目用了哪些技能，以及对应版本

未来企业级方向会包括权限管理、审计日志、内部技能市场等能力，这些都指向「可控地用技能，而不是野生生长」。

---

九、find-skills 的价值不在于「强」，而在于「刚好卡在痛点上」

• find-skills 功能本身不复杂
• 真正的价值，是解决了「发现技能」这个最关键却最容易被忽视的环节

在 Agent 技能生态越滚越大的情况下：

• 没有 find-skills → 找技能像大海捞针
• 有了 find-skills → 一条命令就能精准定位

对个人开发者，它能帮你更快把「想法」连到「现成能力」；对团队，它能大幅压缩调研时间，把更多精力留给架构和业务本身。

---

十、如果你准备把 find-skills 纳入日常工作流，可以这样开始

可以走这么三步（以开发者视角）：

1. 准备环境

   • 检查 Node.js 版本 ≥ 16
   • 确保能正常访问 GitHub

2. 安装 find-skills（项目级或全局）

   # 项目内安装（推荐用于团队协作）
   npx skills add vercel-labs/agent-skills@find-skills
   
   # 或全局安装
   npx skills add vercel-labs/agent-skills@find-skills -g
   

3. 从一个真实问题开始

   • 例如：
     • npx skills find react performance
     • npx skills find pr review
     • npx skills find changelog
   • 装上结果列表里的一个，直接在当前项目试跑一遍。

等你完成两三个真实场景，你大概就会明白：find-skills 不是「锦上添花的小玩具」，更像是未来 AI 编程环境里的「开始菜单」。