ZBUG

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 文件，声明技能名称、描述和详细指令
• 辅助文件（可选）：参考文档、模板、示例、脚本

技能采用渐进式加载设计，分三层按需读取：

1. 元数据层（始终加载）：每个技能仅 ~100 token，让 Claude 知道技能存在
2. 指令层（触发时加载）：完整 SKILL.md 正文，含操作流程和最佳实践
3. 资源层（按需加载）：额外 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 按需变身各领域专家，而不是每次都从头解释背景。

什么是 Claude Code？

Claude Code 是 Anthropic 推出的官方 AI 编程命令行工具（CLI），让你可以直接在终端中与 Claude 协作完成代码编写、调试、重构、文件操作等复杂任务。它能读取你的项目文件、执行命令、理解整个代码库上下文，是目前最强大的 AI 编程助手之一。

安装前提条件

• Node.js 18 或更高版本
• Anthropic 账号（需要 API Key 或 Claude Pro/Max 订阅）
• 稳定的网络连接

macOS 安装

第一步：安装 Node.js

推荐使用 Homebrew 安装：

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

# 验证安装
node --version

第二步：安装 Claude Code

npm install -g @anthropic-ai/claude-code

第三步：启动并登录

claude

首次运行会引导你完成授权登录，支持 Claude.ai 账号（Pro/Max）或直接输入 API Key。

Windows 安装

第一步：安装 Node.js

前往 nodejs.org 下载 Windows 安装包（LTS 版本），或使用 winget：

winget install OpenJS.NodeJS.LTS

第二步：安装 Claude Code

打开 PowerShell 或命令提示符（建议以管理员身份运行）：

npm install -g @anthropic-ai/claude-code

第三步：启动

claude

注意：Windows 上推荐使用 Windows Terminal + PowerShell 7 获得最佳体验。如遇脚本执行策略问题，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Linux 安装

第一步：安装 Node.js

推荐使用 nvm（Node Version Manager）：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载配置
source ~/.bashrc

# 安装最新 LTS 版本
nvm install --lts
nvm use --lts

或使用系统包管理器（Ubuntu/Debian）：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

第二步：安装 Claude Code

npm install -g @anthropic-ai/claude-code

第三步：启动

cd /your/project
claude

基本使用方法

对话模式

直接输入 claude 进入交互模式，用自然语言描述任务：

# 启动交互模式
claude

# 或直接执行单条指令
claude "帮我解释这个项目的结构"
claude "找出所有 TODO 注释"
claude "帮我写单元测试"

常用命令

命令	说明
/help	查看帮助
/clear	清除对话历史
/compact	压缩上下文节省 Token
/commit	自动生成 git commit 并提交
/review	代码审查
! 命令	执行 shell 命令结果进入上下文

实际使用示例

# 分析项目架构
> 分析这个项目的架构，找出潜在的性能问题

# 修复 Bug
> 运行测试并修复所有失败的用例

# 新增功能
> 给用户登录接口添加限流，每分钟最多 5 次

# 代码重构
> 将 utils.js 中的回调函数改写为 async/await 风格

CLAUDE.md：给项目定制上下文

在项目根目录创建 CLAUDE.md 文件，写入项目说明、技术规范、注意事项，Claude Code 每次启动都会自动读取，无需反复解释背景。

# CLAUDE.md 示例
这是一个 Next.js 14 项目，使用 TypeScript 和 Tailwind CSS。
代码规范：ESLint + Prettier，提交前必须通过 lint。
数据库：PostgreSQL，ORM 使用 Prisma。
禁止直接修改 main 分支，所有改动通过 PR 合并。

权限管理

Claude Code 执行文件写入、运行命令等操作前会征求确认。权限控制方式：

• 默认模式：每次敏感操作都会询问
• –dangerously-skip-permissions：跳过所有确认（仅在可信环境下使用）
• 在对话中输入 Always allow：对某类操作永久授权

配置 API Key

# macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"

# Windows PowerShell
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxx"

# 永久生效（写入 ~/.zshrc）
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"' >> ~/.zshrc

总结

Claude Code 将 AI 能力深度集成到开发工作流，无论日常编码、调试还是大规模重构都能显著提升效率。三大平台安装方式一致，核心命令只有一行：npm install -g @anthropic-ai/claude-code。如果你还没试过，强烈建议现在就开始体验。