Agent Skills 是一种为 AI 智能体安装可复用能力模块的标准化机制。通过 skills.sh 平台,你可以一条命令为 Claude Code、Cursor、GitHub Copilot 等 20 余种 AI 工具安装来自社区的专业技能,让智能体变成特定领域的专家。本文以 skills.sh 内置的 Find Skills 为例,完整演示从发现到使用的全流程。
什么是 Agent Skills?
Agent Skills 的核心是一个目录,其中包含:
- SKILL.md(必须):带 YAML frontmatter 的 Markdown 文件,声明技能名称、描述和详细指令
- 辅助文件(可选):参考文档、模板、示例、脚本
技能采用渐进式加载设计,分三层按需读取:
- 元数据层(始终加载):每个技能仅 ~100 token,让 Claude 知道技能存在
- 指令层(触发时加载):完整 SKILL.md 正文,含操作流程和最佳实践
- 资源层(按需加载):额外 Markdown、脚本、数据库等,未使用时零 token 开销
什么是 skills.sh?
skills.sh 是由 Vercel 维护的开源 Agent Skills 目录,目前收录近 90,000 个技能,按安装量排行。它既是发现平台,也提供统一的 CLI 工具管理技能的安装、更新和删除。
安装 Skills CLI
Skills CLI 基于 Node.js,通过 npx 直接运行,无需全局安装:
# 检查是否可用(需 Node.js 18+)
npx skills --version
或全局安装以省去每次输入 npx:
npm install -g skills
使用 Find Skills 发现技能
Find Skills 本身就是一个技能(安装量超 67 万),其作用是帮你在 skills.sh 目录中搜索其他技能。使用方式:
# 基本用法
npx skills find <关键词>
# 示例:搜索与 React 相关的技能
npx skills find react
# 搜索与测试相关的技能
npx skills find testing
# 搜索数据库相关技能
npx skills find database postgresql
执行后,CLI 会返回匹配结果,每条包含:
- 技能名称与描述
- 安装命令
- skills.sh 详情页链接
实操演示
$ npx skills find react
找到 3 个匹配技能:
1. vercel-react-best-practices(238K 安装)
React 最佳实践:组件设计、Hooks 用法、性能优化
安装:npx skills add vercel-labs/react-best-practices
2. react-testing(45K 安装)
React 组件测试:Jest、Testing Library 完整工作流
安装:npx skills add community/react-testing
3. nextjs-patterns(120K 安装)
Next.js App Router 常用模式与约定
安装:npx skills add vercel-labs/nextjs-patterns
安装技能
找到目标技能后,用 add 命令安装。技能分全局和项目级两种安装范围:
# 安装到当前项目(写入 ./.claude/skills/)
npx skills add vercel-labs/react-best-practices
# 安装到全局(所有项目可用)
npx skills add vercel-labs/react-best-practices --global
# 查看已安装的技能
npx skills list
# 更新技能
npx skills update vercel-labs/react-best-practices
# 删除技能
npx skills remove vercel-labs/react-best-practices
在 Claude Code 中使用技能
技能安装后,Claude Code 启动时会自动加载所有技能的元数据。当你的请求匹配某个技能的描述,Claude 会自动激活并加载该技能的完整指令——无需手动调用。
也可以通过 Skill 工具显式触发(在支持的客户端中):
# Claude Code 交互模式下,直接描述任务即可触发匹配的技能
> 帮我给这个 React 组件写测试
# Claude 会自动识别并激活 react-testing 技能
Find Skills 技能本身的工作原理
Find Skills 的 SKILL.md 大致如下:
---
name: find-skills
description: 当用户想发现或搜索 Agent Skills 时使用
---
## 指令
1. 理解用户想要的领域和任务
2. 构造聚焦的搜索关键词
3. 运行 `npx skills find <关键词>`
4. 展示结果:技能名、描述、安装命令、链接
5. 推荐安装量 1K+ 的技能,优先选择官方来源(vercel-labs、Anthropic)
这正是渐进式加载的典型应用:Claude 平时只知道”有这个技能、它的用途”,触发后才读取完整指令,既节省 token,又能精准执行。
选择技能的注意事项
- 优先高安装量:1K+ 安装意味着经过大量用户验证
- 信任官方来源:vercel-labs、Anthropic 官方发布的技能经过安全审计
- 审查未知来源:来历不明的技能可能包含恶意指令,安装前务必查看 SKILL.md 原文
- 项目与全局分开管理:项目专属技能用项目级安装,通用技能才全局安装,避免相互干扰
总结
Agent Skills 用”一次封装、自动触发”的方式把专业知识注入 AI 智能体。借助 skills.sh 的 Find Skills,搜索和安装社区技能只需两条命令:npx skills find <关键词> 发现,npx skills add <owner/repo> 安装。从此让 Claude Code 按需变身各领域专家,而不是每次都从头解释背景。