AI 2026年3月22日 4 分钟阅读

skills.sh 完全指南：用 find-skills 发现 AI 代理的无限可能

tinyash 0 条评论

文章信息

发布时间 2026年3月22日
作者 tinyash
阅读时长 4 分钟阅读

摘要：skills.sh 是由 Vercel Labs 开发的开放 Agent 技能生态系统，提供了一个统一的技能发现、安装和管理平台。本文重点介绍 skills.sh 的核心功能，特别是 find-skills 技能搜索工具，帮助你快速找到适合项目的 AI 代理技能。

一、skills.sh 是什么？

skills.sh 是一个开放的 Agent 技能生态系统，由 Vercel Labs 开发。它的目标是：

让 AI 代理技能像 npm 包一样易于发现、安装和共享。

1.1 核心概念

技能（Skills） 是什么？

技能是 AI 代理的可复用能力模块，类似于：

浏览器的扩展/插件
Node.js 的npm 包
VS Code 的扩展市场

每个技能是一个包含 SKILL.md 文件的目录，定义了：

技能名称和描述
触发条件（什么时候使用）
执行步骤（具体怎么做）
输出规范（应该产生什么结果）

1.2 为什么需要 skills.sh？

问题：AI 代理（Claude Code、Codex、Cursor 等）都有技能系统，但：

没有统一的发现平台
技能格式不统一
安装方式各异
质量参差不齐

解决方案：skills.sh 提供：

✅ 统一市场：一个地方发现所有技能
✅ 统一格式：遵循 Agent Skills 规范
✅ 统一安装：一条命令安装到任何代理
✅ 质量排行：基于匿名使用数据的排行榜

1.3 支持的 AI 代理

skills.sh 支持 40+ 个 AI 编码代理，包括：

代理	–agent 参数	项目路径	全局路径
Claude Code	`claude-code`	`.claude/skills/`	`~/.claude/skills/`
Codex	`codex`	`.agents/skills/`	`~/.codex/skills/`
Cursor	`cursor`	`.agents/skills/`	`~/.cursor/skills/`
OpenCode	`opencode`	`.agents/skills/`	`~/.config/opencode/skills/`
OpenClaw	`openclaw`	`skills/`	`~/.openclaw/skills/`
Gemini CLI	`gemini-cli`	`.agents/skills/`	`~/.gemini/skills/`
GitHub Copilot	`github-copilot`	`.agents/skills/`	`~/.copilot/skills/`
Cline	`cline`	`.agents/skills/`	`~/.agents/skills/`
Windsurf	`windsurf`	`.windsurf/skills/`	`~/.codeium/windsurf/skills/`
…	…	…	…

完整列表见官方文档。

二、快速开始

2.1 安装 skills CLI

skills.sh 通过 npm 分发，无需全局安装：

# 直接使用 npx（推荐）
npx skills add vercel-labs/agent-skills

# 或者全局安装
npm install -g @vercel/skills

2.2 安装第一个技能

# 安装 Vercel Labs 的官方技能包
npx skills add vercel-labs/agent-skills

安装过程：

CLI 检测你安装的 AI 代理
询问安装到哪个代理
选择安装方式（符号链接或复制）
完成安装

2.3 验证安装

# 列出已安装的技能
npx skills list

# 或简写
npx skills ls

三、find-skill：核心功能详解

find-skill 是 skills.sh 的核心搜索功能，帮助你快速找到需要的技能。

3.1 交互式搜索

启动交互式搜索界面：

npx skills find

功能特点：

🔍 fzf 风格界面：类似 fuzzy finder 的交互体验
⌨️ 键盘导航：上下箭头选择，Enter 确认
📊 实时预览：显示技能描述和详细信息
🎯 多选支持：可以选择多个技能批量安装

界面示例：

❯ Search skills...
  ─────────────────────────────────────
  ▶ vercel-labs/agent-skills
    frontend-design - Frontend design guidelines and best practices
    skill-creator - Create new skills following best practices
    web-design-guidelines - Web design principles and accessibility
    
  ▶ microsoft/azure-skills
    azure-deployment - Deploy to Azure services
    azure-security - Azure security best practices
    
  ▶ inferen-sh/skills
    code-review - Automated code review checklist
    testing-strategies - Testing methodology and patterns

3.2 关键词搜索

通过关键词直接搜索：

# 搜索包含 "typescript" 的技能
npx skills find typescript

# 搜索包含 "react" 的技能
npx skills find react

# 搜索包含 "security" 的技能
npx skills find security

搜索结果：

匹配技能名称
匹配技能描述
匹配技能内容关键词

3.3 搜索技巧

精确匹配

# 搜索确切名称的技能
npx skills find "frontend-design"

多关键词

# 搜索包含多个关键词的技能
npx skills find "react typescript"

过滤搜索结果

# 先列出，再手动选择
npx skills add vercel-labs/agent-skills --list

3.4 在 skills.sh 网站搜索

访问 https://skills.sh 使用网页版搜索：

功能：

📊 技能排行榜：按安装量排序
🔍 搜索框：输入关键词搜索
📁 分类浏览：按仓库/作者浏览
📈 使用统计：查看技能安装次数

排行榜示例：

Top Skills (by installations)

┌─────────────────────────────────────────────────────┐
│ +16 more from microsoft/github-copilot-for-azure    │
│ 2.4M total installations                              │
├─────────────────────────────────────────────────────┤
│ +10 more from inferen-sh/skills                     │
│ 1.0M total installations                              │
├─────────────────────────────────────────────────────┤
│ +18 more from microsoft/azure-skills                │
│ 1.4M total installations                              │
└─────────────────────────────────────────────────────┘

四、技能安装方式

4.1 安装来源

skills.sh 支持多种技能来源：

# GitHub 仓库（简写）
npx skills add vercel-labs/agent-skills

# GitHub 完整 URL
npx skills add https://github.com/vercel-labs/agent-skills

# 指定分支/目录
npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# GitLab URL
npx skills add https://gitlab.com/org/repo

# 任意 Git URL
npx skills add git@github.com:vercel-labs/agent-skills.git

# 本地路径
npx skills add ./my-local-skills

4.2 安装选项

选项	说明
`-g, --global`	安装到用户目录（全局可用）
`-a, --agent <agents...>`	指定目标代理
`-s, --skill <skills...>`	安装特定技能（使用 `*` 安装全部）
`-l, --list`	列出可用技能，不安装
`--copy`	复制文件而非符号链接
`-y, --yes`	跳过所有确认提示
`--all`	安装所有技能到所有代理

4.3 安装示例

# 列出技能（不安装）
npx skills add vercel-labs/agent-skills --list

# 安装特定技能
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# 安装到特定代理
npx skills add vercel-labs/agent-skills -a claude-code -a opencode

# 非交互式安装（CI/CD 友好）
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

# 安装所有技能到所有代理
npx skills add vercel-labs/agent-skills --all

# 安装所有技能到特定代理
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code

4.4 安装范围

范围	标志	位置	使用场景
项目	（默认）	`./<agent>/skills/`	与项目一起提交，团队共享
全局	`-g`	`~/<agent>/skills/`	所有项目可用

建议：

团队项目 → 使用项目级安装
个人工具 → 使用全局安装

4.5 安装方式

方式	说明
符号链接（推荐）	创建从代理目录到规范副本的符号链接。单一事实来源，易于更新。
复制	为每个代理创建独立副本。当不支持符号链接时使用。

五、技能管理

5.1 列出已安装技能

# 列出所有已安装技能（项目 + 全局）
npx skills list

# 或简写
npx skills ls

# 只列出全局技能
npx skills ls -g

# 按代理过滤
npx skills ls -a claude-code -a cursor

输出示例：

Installed Skills

Project (.claude/skills/):
  ├── frontend-design (vercel-labs/agent-skills)
  ├── skill-creator (vercel-labs/agent-skills)
  └── web-design-guidelines (vercel-labs/agent-skills)

Global (~/.claude/skills/):
  └── code-review (inferen-sh/skills)

5.2 检查更新

# 检查是否有可用更新
npx skills check

# 更新所有技能
npx skills update

5.3 移除技能

# 交互式移除（选择要移除的技能）
npx skills remove

# 移除特定技能
npx skills remove web-design-guidelines

# 移除多个技能
npx skills remove frontend-design web-design-guidelines

# 从全局范围移除
npx skills remove --global web-design-guidelines

# 从特定代理移除
npx skills remove --agent claude-code cursor my-skill

# 移除所有技能（无需确认）
npx skills remove --all

# 从特定代理移除所有技能
npx skills remove --skill '*' -a cursor

# 从所有代理移除特定技能
npx skills remove my-skill --agent '*'

# 使用 rm 别名
npx skills rm my-skill

移除选项：

选项	说明
`-g, --global`	从全局范围移除
`-a, --agent`	从特定代理移除（使用 `*` 表示所有）
`-s, --skill`	指定要移除的技能（使用 `*` 表示所有）
`-y, --yes`	跳过确认提示
`--all`	`--skill '' --agent '' -y` 的简写

六、创建自定义技能

6.1 初始化技能模板

# 在当前目录创建 SKILL.md
npx skills init

# 在子目录创建新技能
npx skills init my-skill

6.2 SKILL.md 格式

---
name: my-skill
description: 技能描述和使用时机
---

# 技能名称

## 使用时机

描述应该使用这个技能的场景。

## 步骤

1. 第一步
2. 第二步
3. ...

## 输出规范

应该产生什么结果。

6.3 元数据选项

---
name: my-internal-skill
description: 内部技能，默认不显示
metadata:
  internal: true  # 隐藏技能，只有设置 INSTALL_INTERNAL_SKILLS=1 时才可见
---

使用内部技能：

INSTALL_INTERNAL_SKILLS=1 npx skills add vercel-labs/agent-skills --list

6.4 技能搜索位置

CLI 在以下位置搜索技能：

根目录（如果包含 SKILL.md）
skills/
skills/.curated/
skills/.experimental/
skills/.system/
.agents/skills/
.claude/skills/
.opencode/skills/
...（各代理特定目录）

如果标准位置没有找到技能，会执行递归搜索。

6.5 示例：代码审查技能

---
name: code-review-checklist
description: 代码提交前的自动审查清单
---

# 代码审查技能

## 使用时机

- 代码提交前
- Pull Request 创建后
- 收到审查请求时

## 审查清单

### 代码质量
- [ ] 代码遵循项目风格指南
- [ ] 没有明显的性能问题
- [ ] 错误处理完整
- [ ] 日志记录适当

### 测试
- [ ] 单元测试已添加
- [ ] 测试覆盖关键路径
- [ ] 所有测试通过

### 安全
- [ ] 没有硬编码的密钥
- [ ] 输入已验证
- [ ] SQL 注入防护
- [ ] XSS 防护

### 文档
- [ ] 代码注释清晰
- [ ] API 文档已更新
- [ ] CHANGELOG 已更新

## 执行步骤

1. 运行 linter 检查代码风格
2. 运行测试套件
3. 检查安全扫描结果
4. 审查文档完整性
5. 生成审查报告

## 输出规范

- 审查报告（Markdown 格式）
- 问题列表（按严重程度排序）
- 修复建议

七、技能兼容性

7.1 Agent Skills 规范

skills.sh 遵循 Agent Skills 规范，确保技能在不同代理间兼容。

7.2 功能支持矩阵

功能	OpenCode	Claude Code	Cursor	Codex	OpenClaw
基础技能	✅	✅	✅	✅	✅
allowed-tools	✅	✅	✅	✅	✅
context: fork	❌	✅	❌	❌	❌
Hooks	❌	✅	❌	❌	❌

注意：

基础技能在所有代理上都工作
高级功能（如 Hooks、context: fork）可能仅部分代理支持

7.3 特殊配置

Kiro CLI 用户：安装技能后，需要手动添加到自定义代理资源：

// .kiro/agents/<agent>.json
{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

八、环境变量配置

变量	说明
`INSTALL_INTERNAL_SKILLS`	设置为 `1` 或 `true` 显示内部技能
`DISABLE_TELEMETRY`	禁用匿名使用遥测
`DO_NOT_TRACK`	禁用遥测的替代方式

示例：

# 安装内部技能
INSTALL_INTERNAL_SKILLS=1 npx skills add vercel-labs/agent-skills --list

# 禁用遥测
DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills

九、遥测与隐私

skills.sh 收集匿名使用数据以改进工具：

收集内容：

✅ 技能安装次数
✅ 技能来源仓库

不收集：

❌ 个人信息
❌ 使用模式
❌ 代码内容
❌ 项目信息

自动禁用：

CI/CD 环境中自动禁用遥测

手动禁用：

DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills

十、安全考虑

10.1 安全审计

skills.sh 进行常规安全审计，评估技能内容的恶意性。

10.2 报告安全问题

发现安全问题，请访问：https://security.vercel.com

10.3 使用建议

⚠️ 重要：

安装前审查技能内容
优先选择安装量高的技能
注意技能权限要求
定期更新技能

十一、实战示例

11.1 示例 1：为团队项目安装技能

场景：为新项目配置统一的代码质量标准

# 1. 创建项目
mkdir my-project && cd my-project
git init

# 2. 安装技能到项目（团队共享）
npx skills add vercel-labs/agent-skills --skill frontend-design --skill code-review

# 3. 验证安装
npx skills ls

# 4. 提交技能配置
git add .claude/skills/  # 或其他代理目录
git commit -m "chore: add agent skills for code quality"

效果：团队成员克隆项目后，自动拥有相同的技能配置。

11.2 示例 2：个人全局技能配置

场景：配置个人常用的技能，所有项目可用

# 1. 安装常用技能到全局
npx skills add vercel-labs/agent-skills -g -a claude-code -y
npx skills add inferen-sh/skills -g -a claude-code -y

# 2. 列出全局技能
npx skills ls -g

# 3. 定期更新
npx skills update

11.3 示例 3：CI/CD 自动化安装

场景：在 CI 流水线中自动安装技能

# .github/workflows/ci.yml
name: CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      
      - name: Install Agent Skills
        run: |
          npx skills add vercel-labs/agent-skills \
            --skill frontend-design \
            --skill code-review \
            -a claude-code \
            -y \
            --global
      
      - name: Run Tests
        run: npm test

11.4 示例 4：使用 find-skills 发现技能

场景：寻找 React 相关的最佳实践技能

# 1. 交互式搜索 React 技能
npx skills find react

# 2. 浏览搜索结果，选择安装
# （使用箭头键选择，Enter 确认）

# 3. 或者直接在网站搜索
# 访问 https://skills.sh 搜索 "react"

十二、故障排查

12.1 技能未显示

可能原因：

技能未正确安装
SKILL.md 格式错误
代理未重新加载

解决方法：

# 验证安装
npx skills ls

# 检查 SKILL.md 格式
cat .claude/skills/my-skill/SKILL.md

# 重启代理

12.2 安装失败

可能原因：

网络问题
权限不足
Git 仓库不存在

解决方法：

# 检查网络连接
curl https://github.com

# 检查目录权限
ls -la ~/.claude/

# 验证仓库 URL
git ls-remote https://github.com/owner/repo

12.3 技能不工作

可能原因：

代理不支持某些功能
技能与代理版本不兼容
环境变量未配置

解决方法：

查看代理文档确认支持的功能
更新代理到最新版本
检查技能所需的环境变量

十三、最佳实践

13.1 技能选择

✅ 优先选择安装量高的技能
✅ 查看技能评价和更新频率
✅ 阅读 SKILL.md 了解使用条件
✅ 检查技能依赖（环境变量、二进制文件）

13.2 技能组织

项目技能 → 与代码一起提交
个人技能 → 使用全局安装
实验技能 → 使用 skills/.experimental/ 目录

13.3 技能维护

定期运行 npx skills check 检查更新
移除不再使用的技能
关注技能仓库的更新日志

13.4 技能贡献

想贡献技能到 ecosystem：

Fork vercel-labs/agent-skills 或创建自己的仓库
遵循 SKILL.md 格式创建技能
测试技能在多个代理上的表现
提交 PR 或发布仓库
在 skills.sh 上获得曝光

十四、与 OpenClaw 技能系统集成

如果你使用 OpenClaw，skills.sh 安装的技能可以直接使用：

# 安装技能到 OpenClaw
npx skills add vercel-labs/agent-skills -a openclaw

# 技能会安装到 ~/.openclaw/skills/

# 验证
npx skills ls -a openclaw

与 ClawHub 的关系：

skills.sh → 通用技能市场（跨平台）
ClawHub → OpenClaw 专用技能市场

两者可以共存，互为补充。

十五、总结

skills.sh 核心价值：

✅ 统一发现：一个地方找到所有 AI 代理技能
✅ 统一安装：一条命令安装到任何代理
✅ 统一格式：遵循 Agent Skills 规范
✅ 质量排行：基于真实使用数据的排行榜
✅ 易于管理：完整的安装、更新、移除工作流

find-skill 核心功能：

🔍 交互式搜索（fzf 风格）
📝 关键词搜索
📊 技能排行榜浏览
🎯 精确技能定位

下一步行动：

尝试安装第一个技能：npx skills add vercel-labs/agent-skills
使用 find-skill 探索：npx skills find
浏览技能市场：https://skills.sh
考虑贡献你的技能到社区

参考资料：

本文基于 skills.sh v1.x 编写，命令和格式可能随版本更新而变化。请参考官方文档获取最新信息。

AI AI 工具

一、skills.sh 是什么？

1.1 核心概念

1.2 为什么需要 skills.sh？

1.3 支持的 AI 代理

二、快速开始

2.1 安装 skills CLI

2.2 安装第一个技能

2.3 验证安装

三、find-skill：核心功能详解

3.1 交互式搜索

3.2 关键词搜索

3.3 搜索技巧

精确匹配

多关键词

过滤搜索结果

3.4 在 skills.sh 网站搜索

四、技能安装方式

4.1 安装来源

4.2 安装选项

4.3 安装示例

4.4 安装范围

4.5 安装方式

五、技能管理

5.1 列出已安装技能

5.2 检查更新

5.3 移除技能

六、创建自定义技能

6.1 初始化技能模板

6.2 SKILL.md 格式

6.3 元数据选项

6.4 技能搜索位置

6.5 示例：代码审查技能

七、技能兼容性

7.1 Agent Skills 规范

7.2 功能支持矩阵

7.3 特殊配置

八、环境变量配置

九、遥测与隐私

十、安全考虑

10.1 安全审计

10.2 报告安全问题

10.3 使用建议

十一、实战示例

11.1 示例 1：为团队项目安装技能

11.2 示例 2：个人全局技能配置

11.3 示例 3：CI/CD 自动化安装

11.4 示例 4：使用 find-skills 发现技能

十二、故障排查

12.1 技能未显示

12.2 安装失败

12.3 技能不工作

十三、最佳实践

13.1 技能选择

13.2 技能组织

13.3 技能维护

13.4 技能贡献

十四、与 OpenClaw 技能系统集成

十五、总结

发表评论 取消回复

发表评论取消回复