# find-skills

## 功能简介

该技能帮助你在开放的智能体技能生态中发现并安装所需技能。

## 适用场景

当用户出现以下情况时，可使用此技能：

- 提问“如何实现 X”，而 X 是一个已有对应技能的常见任务；
- 明确提出“为 X 找个技能”或“有没有 X 相关的技能”；
- 询问“你能做 X 吗”，其中 X 是某项专业能力（如代码审查、性能优化等）；
- 表达希望扩展智能体能力的意愿；
- 想搜索工具、模板或工作流；
- 提及在特定领域（如设计、测试、部署等）需要辅助支持。

## 什么是 Skills CLI？

Skills CLI（`npx skills`）是开放智能体技能生态的包管理器。技能是以模块化方式封装的软件包，用于通过专业知识、预置工作流和工具来扩展智能体能力。

常用命令如下：

- `npx skills find [query]` —— 按关键词交互式搜索技能；
- `npx skills add <repo-url>` —— 从 GitHub 等源安装技能；
- `npx skills check` —— 检查已安装技能的更新状态；
- `npx skills update` —— 更新所有已安装技能。

技能库浏览地址：[https://skills.sh/](https://skills.sh/)

## 协助用户查找技能的步骤

### 第一步：明确用户需求

当用户请求帮助时，请识别：

- 所属领域（如 React、测试、UI 设计、部署等）；
- 具体任务（如编写单元测试、生成动画、审查 PR）；
- 该任务是否足够常见，很可能已有成熟技能覆盖。

### 第二步：优先查阅排行榜

在执行 CLI 搜索前，建议先访问 [skills.sh 排行榜](https://skills.sh/)，查看该领域内高安装量、经实战验证的热门技能。

例如 Web 开发方向的头部技能包括：

- `vercel-labs/agent-skills` —— 支持 React、Next.js、网页设计（各超 10 万次安装）；
- `anthropics/skills` —— 覆盖前端设计、文档处理（各超 10 万次安装）。

### 第三步：执行技能搜索

若排行榜未覆盖用户需求，则运行搜索命令：

```
npx skills find [query]
```

示例：

- 用户问：“如何提升我的 React 应用性能？” → `npx skills find react performance`；
- 用户问：“能帮我做 PR 审查吗？” → `npx skills find pr review`；
- 用户问：“我需要生成一份变更日志。” → `npx skills find changelog`。

### 第四步：推荐前验证技能质量

**切勿仅凭搜索结果直接推荐。** 请务必核查以下维度：

- **安装量**：优先选择 ≥1,000 次安装的技能；安装量 <100 的需谨慎评估；
- **来源可信度**：官方组织（如 `vercel-labs`、`anthropics`、`microsoft`）发布的技能更可靠；
- **GitHub Star 数**：前往源仓库查看活跃度与社区反馈；
- **README 与文档完整性**：确认有清晰说明、示例及维护状态。

安装时可添加参数提升效率：

```
npx skills add <repo-url> -g -y
```

其中 `-g` 表示全局安装（用户级），`-y` 跳过确认提示。

## 常见技能分类与搜索关键词

| 分类         | 示例关键词                     |
|--------------|----------------------------------|
| Web 开发     | `react`, `nextjs`, `typescript`, `css`, `tailwind` |
| 测试         | `testing`, `jest`, `playwright`, `e2e` |
| DevOps       | `deploy`, `docker`, `kubernetes`, `ci-cd` |
| 文档         | `docs`, `readme`, `changelog`, `api-docs` |
| 代码质量     | `review`, `lint`, `refactor`, `best-practices` |
| 设计         | `ui`, `ux`, `design-system`, `accessibility` |
| 效率提升     | `workflow`, `automation`, `git` |

## 高效搜索技巧

- 使用**具体关键词**：例如 `react testing` 优于泛泛的 `testing`；
- 尝试**同义替换**：若 `deploy` 无结果，可试 `deployment` 或 `ci-cd`；
- 关注**主流来源**：许多优质技能来自 `vercel-labs/agent-skills` 或 `ComposioHQ/awesome-claude-skills`。

## 未找到匹配技能时的应对策略

若搜索无果，请：

- 明确告知用户暂无匹配技能；
- 主动提供通用能力支持，直接协助完成该任务；
- 建议用户基于 `npx skills init` 创建专属技能。

示例响应：

```
我搜索了与 "xyz" 相关的技能，但暂未发现匹配项。
我仍可直接帮您完成这项任务！是否现在开始？

如果这是您高频使用的功能，也可以自行创建一个技能：
npx skills init my-xyz-skill
```