Claude Code Skills 使用教程

Thu, 02 Apr 2026 00:00:00 +0000

什么是 Skills

Skills（技能）是 Claude Code 的扩展机制，类似于 IDE 的插件系统。每个 Skill 封装了特定领域的知识、工作流程和工具集成，安装后 Claude Code 便自动获得该领域的能力。

打个比方：MCP 是给 Claude 接上外部工具（手），Skills 是教会 Claude 特定的工作方法（脑）。

Skills 生态基于 npx skills CLI 管理，社区贡献的 Skills 托管在 skills.sh，可以自由查找和安装。

Skills vs MCP

很多同学会把两者搞混，先区分一下：

维度	Skills	MCP
本质	提示词 + 工作流模板	工具/数据源连接协议
作用	教 Claude"怎么做"	让 Claude"能访问什么"
配置	`npx skills add` 安装	`.claude/claude.json` 配置
示例	自动生成 commit、代码审查	文件系统、GitHub API

两者互补，经常配合使用。比如安装了 gh-cli Skill，还需要 GitHub MCP 提供 API 访问能力。

查找 Skills

方式一：命令行搜索

`1`	`npx skills find <关键词>`

例如：

1
2
3

npx skills find github     # 搜索 GitHub 相关 Skill
npx skills find react      # 搜索 React 相关 Skill
npx skills find testing    # 搜索测试相关 Skill

搜索结果会显示 Skill 名称、安装量和详情链接。

方式二：浏览在线市场

访问 skills.sh 查看排行榜，按安装量排序。热门 Skill 通常更可靠。

目前最受欢迎的 Skill 系列：

系列	来源	热门 Skill
`vercel-labs/agent-skills`	Vercel 官方	react-best-practices, next-js, web-design
`github/awesome-copilot`	GitHub	git-commit, gh-cli, prd
`anthropics/skills`	Anthropic 官方	frontend-design, document-processing

挑选 Skill 的三条原则

安装量优先 — 选 1K+ 安装量的，避开 < 100 的
来源可靠 — 官方来源（vercel-labs、anthropics、github）优先
安全审计通过 — 安装时注意看 Gen、Socket、Snyk 的审计结果

安装 Skills

基本命令

`1`	`npx skills add <owner/repo@skill-name> -g -y`

参数说明：

-g：全局安装（用户级，所有项目可用）
-y：跳过确认提示

安装示例

安装 git-commit Skill，用于自动生成规范的 commit 信息：

`1`	`npx skills add github/awesome-copilot@git-commit -g -y`

安装 gh-cli Skill，辅助 GitHub CLI 操作：

`1`	`npx skills add github/awesome-copilot@gh-cli -g -y`

安装成功后，Skill 文件存放于 ~/.agents/skills/ 目录。

安装输出解读

安装过程会显示：

◇  Source: https://github.com/github/awesome-copilot.git@git-commit
◇  Repository cloned
◇  Found 308 skills
●  Selected 1 skill: git-commit
◇  45 agents
●  Installing to: Claude Code, OpenClaw, Codex, Trae CN

◇  Installation Summary
  ~\.agents\skills\git-commit
    universal: Codex, Amp, Antigravity, Cline, Cursor +7 more
    symlink → Claude Code, OpenClaw, Trae CN

◇  Security Risk Assessments
  git-commit  Safe  0 alerts  Low Risk

◇  Installed 1 skill
✓ ~\.agents\skills\git-commit

关键信息：

agents：支持 45 种 AI 编程工具
Security Risk：Gen 评为 Safe、Socket 0 alerts 即安全
symlink：Claude Code 通过符号链接加载

使用 Skills

安装后无需额外配置，Skill 会自动生效。有两种触发方式：

自动触发

当对话内容命中 Skill 的适用场景时，Claude Code 会自动调用。例如安装了 git-commit 后，说"帮我提交代码"，Claude 就会用该 Skill 生成规范 commit。

手动调用

使用 / 斜杠命令显式调用：

`1`	`/git-commit`

/skills 命令可以查看当前已安装的所有 Skill。

管理 Skills

查看已安装

`1`	`npx skills list`

检查更新

`1`	`npx skills check`

更新所有 Skill

`1`	`npx skills update`

锁定版本

安装 Skill 后会自动生成 skills-lock.json（类似 package-lock.json），锁定版本到当前 tag 对应的 commit。将该文件提交到 Git 仓库，团队成员拉取后可用 npx skills install 安装完全相同的版本。

1
2

git add skills-lock.json
git commit -m "chore: lock skill versions"

常用 Skill 推荐

开发效率

Skill	用途	安装量
`github/awesome-copilot@git-commit`	自动生成规范 commit	26.7K
`github/awesome-copilot@gh-cli`	GitHub CLI 辅助	19.3K
`github/awesome-copilot@prd`	自动生成 PR 描述	15.8K

安装：

1
2

npx skills add github/awesome-copilot@git-commit -g -y
npx skills add github/awesome-copilot@gh-cli -g -y

代码质量

Skill	用途	安装量
`simplify` (内置)	审查代码质量和效率	内置
`security-review` (内置)	安全审查	内置
`review` (内置)	PR Review	内置

注：simplify、security-review、review 是 Claude Code 自带的基础 Skill，无需额外安装。

前端开发

`1`	`npx skills add vercel-labs/agent-skills@react-best-practices -g -y`

Skill 与 CLAUDE.md 配合

CLAUDE.md 是项目级的指令文件，告诉 Claude 项目的上下文信息。Skills + CLAUDE.md 的组合效果最佳：

项目根目录/
├── CLAUDE.md          # 项目说明（技术栈、目录结构、约定）
├── skills-lock.json   # Skill 版本锁定
└── .claude/
    └── claude.json    # MCP 配置

三者分工明确：CLAUDE.md 描述项目，Skills 赋予领域能力，MCP 连接外部工具。

常见问题

安装时 clone 很慢

GitHub 仓库克隆失败或速度慢时，可以设置代理：

`1`	`git config --global http.proxy http://127.0.0.1:7890`

Skill 不生效

确认 Skill 已安装成功：npx skills list
重启 Claude Code
确认项目根目录下没有冲突的 .agents/ 目录

多个 Agent 工具的 Skill 隔离

~/.agents/skills/ 是通用 Skill 目录，Claude Code 通过 symlink 引用。如果你同时使用 Codex、Cursor 等工具，同一个 Skill 会被共享，这是预期行为。

小结

查找：npx skills find <关键词>
安装：npx skills add <owner/repo@skill> -g -y
使用：自动触发或 /skill名 手动调用
管理：npx skills list / check / update

Skills 让 Claude Code 从通用助手变成领域专家，是提升效率的核心手段。

Skills on 你怂你mua