目录

1. 什么是 Skill

2. 内置 Skill 速览

3. 去哪里找 Skill

4. 安装 Skill（3 种方法）

5. 使用 Skill

6. 自己写一个 Skill

7. 常见问题

---

1. 什么是 Skill

Skill 是 Claude Code 的能力扩展模块。每个 Skill 是一份 Markdown 格式的指令文件（SKILL.md），告诉 Claude 在特定场景下应该怎么干活。

你可以把它理解为：

给 AI 助手装一个 "专业技能包" —— 没装之前它也能干，装了之后它按最佳实践来干。

Skill 基于开放的 Agent Skills 标准（agentskills.io），同一份 Skill 文件可以在 Claude Code、Cursor、Codex CLI、Gemini CLI 等 30+ 个 AI 编程工具之间通用。

对于第一次接触 Skills 的读者，更推荐直接从 skills.sh 入手。The Agent Skills Directory

Skill 能做什么

场景	对应 Skill
帮你做 PPT	pptx-author
审查代码 / PR	review
安全审查	security-review
优化代码质量	simplify
写前端页面有独特设计感	frontend-design
调试 Claude API 调用	claude-api
生成 Excel 模型	excel-author

---

2. 内置 Skill 速览

Claude Code 自带一批 Skill，开箱即用，输入 /<名称> 即可调用：

命令	作用
/review	审查当前分支的 Pull Request
/security-review	安全审查代码改动
/simplify	检查代码的复用性、质量和效率
/init	为新项目生成 CLAUDE.md 配置文件
/loop	定时重复执行某个命令（如每 5 分钟检查部署状态）
/update-config	修改 Claude Code 的设置、权限、环境变量
/keybindings-help	自定义键盘快捷键
/fewer-permission-prompts	减少权限弹窗
/pptx-author	用 Python 生成 PPT 文件
/claude-api	构建和调试 Claude API 应用

---

3. 去哪里找 Skill

3.1 官方仓库

Anthropic 官方维护了一个公开 Skill 仓库：

https://github.com/anthropics/skills

包含 frontend-design、excel-author 等常用 Skill。

3.2 社区市场 / 注册中心

名称	规模	地址
TokRepo	500+ Skill，中英双语，社区排名	tokrepo 网站
Claude Plugins Registry	6 万+ Skill	claude-plugins.dev
Netresearch Marketplace	40 个精选 Skill	netresearch.github.io/claude-code-marketplace
daymade 合集	64 个生产级 Skill	github.com/daymade/claude-code-skills

3.3 GitHub 搜索

直接搜 SKILL.md 文件：

https://github.com/search?q=SKILL.md+claude+code&type=code

---

4. 安装 Skill（4 种方法）

方法一：插件市场安装（推荐）

Claude Code 内置插件市场，一条命令搞定：

# 1. 添加市场源
/plugin marketplace add anthropics/skills
​
# 2. 安装具体 Skill
/plugin install frontend-design

部分社区市场也能这样加：

/plugin marketplace add daymade/claude-code-skills
/plugin marketplace add jmichaelschmidt/skills-public

方法二：npx 命令行安装

使用 skills CLI 工具（第三方，支持跨平台）：

# 格式：npx skills add <仓库地址> --skill <skill名称>
npx skills add https://github.com/anthropics/skills --skill frontend-design

注意：这个方法依赖 npm 网络，国内用户可能需要配置镜像。

方法三：Git 克隆 + 手动复制

最直接的方式，不依赖任何工具：

# Step 1: 克隆仓库
git clone https://github.com/anthropics/skills --depth 1 /tmp/skills-repo
​
# Step 2: 查看有哪些 Skill
ls /tmp/skills-repo/
​
# Step 3: 复制到你想要的位置
# Claude Code 默认读取 ~/.claude/skills/ 目录
cp -r /tmp/skills-repo/frontend-design ~/.claude/skills/
​
# 跨 Agent 通用目录（如果你用多款 AI 工具）
cp -r /tmp/skills-repo/frontend-design ~/.agents/skills/

或者直接从 GitHub 网页下载 ZIP，解压后把对应文件夹复制到 ~/.claude/skills/。

---

Skill 存放位置说明

Claude Code 按以下优先级查找 Skill：

路径	作用域	说明
<项目>/.claude/skills/	当前项目	团队共享，适合放到 Git 仓库
~/.claude/skills/	当前用户	个人使用，所有项目都能用
~/.agents/skills/	跨工具通用	Cursor、Codex 等也能读取

---

5. 使用 Skill

5.1 斜杠命令（最常用）

在 Claude Code 对话中输入 /<skill名> 直接调用：

/pptx-author
/security-review
/frontend-design

5.2 描述需求自动匹配

你不需要记住所有 Skill 名。直接说你要干什么，Claude Code 会自动匹配：

你：帮我审查一下代码
Claude Code：自动调用 review skill
​
你：帮我检查安全问题
Claude Code：自动调用 security-review skill
​
你：给我生成一个 PPT
Claude Code：自动调用 pptx-author skill

5.3 实战示例：用 frontend-design 做一个页面

完整流程演示：

第 1 步 —— 安装
─────────────────────────────────
$ npx skills add https://github.com/anthropics/skills --skill frontend-design
​
第 2 步 —— 对话中使用
─────────────────────────────────
你：给我做一个移动端登录页面，Vue3 + TailwindCSS，简约风格
​
Claude Code 会：
  1. 读取 frontend-design skill 的设计规范
  2. 先出设计计划（色彩、字体、布局、签名元素）
  3. 避开 AI 模板套路（暖奶油+陶土色 / 纯黑+荧光绿 / 报纸栏式）
  4. 给出有辨识度的独特设计
  5. 写代码实现

---

6. 自己写一个 Skill

6.1 Skill 文件结构

一个 Skill 就是放在某个文件夹里的 SKILL.md 文件：

my-skill/
└── SKILL.md

6.2 SKILL.md 模板

---
name: my-code-review
description: 按我们团队的规范做代码审查——检查命名、错误处理、安全漏洞
---
​
# My Code Review
​
## 审查流程
​
1. 先看文件结构是否合理
2. 检查函数命名是否符合团队规范（驼峰命名，动词开头）
3. 检查是否有未处理的错误路径
4. 检查是否有 XSS / SQL 注入等安全隐患
5. 输出审查报告，分 "必须修改" 和 "建议优化" 两类
​
## 团队规范要点
​
- 组件名用 PascalCase
- API 请求必须有超时和错误处理
- 用户输入必须做校验和转义
- 不要往 console 打敏感信息

6.3 放到对应目录即可生效

# 个人使用
mkdir -p ~/.claude/skills/my-code-review
# 把 SKILL.md 放进去
​
# 团队共享
mkdir -p ./my-project/.claude/skills/my-code-review
# 把 SKILL.md 放进去，提交到 Git

放好之后，在 Claude Code 会话中提到 "代码审查" 时它就会自动按你的规范来审。

---

7. 常见问题

Q1：安装的 Skill 没生效？

检查 Skill 是否放对了目录：

ls ~/.claude/skills/
ls .claude/skills/

确认 SKILL.md 文件存在且内容不为空。

Q2：多个 Skill 冲突了怎么办？

Claude Code 会同时读取所有 Skill。如果你装了多个 Skill 且它们给出了矛盾的指示，优先使用项目级 Skill（.claude/skills/），它会覆盖用户级（~/.claude/skills/）。

Q3：怎么知道当前会话用了哪些 Skill？

在对话中问 Claude Code：

当前加载了哪些 skill？

Q4：npm 安装报权限错误？

Windows 下常见问题，换缓存目录：

npm install --cache "$HOME/.npm-cache"

或者用方法三（Git 克隆手动复制），完全绕过 npm。

Q5：Skill 和 MCP 工具有什么区别？

	Skill	MCP 工具
本质	Markdown 指令文件	连接外部服务的服务器
作用	告诉 AI 怎么做	让 AI 能调用外部 API
复杂度	低，纯文本	高，需要编程
例子	代码审查规范、设计指南	连接数据库、发送 Slack 消息

两者互补：Skill 定规矩，MCP 给能力。

---

附录：快速上手 Checklist

• 了解 Claude Code 内置了哪些 Skill（/help 查看）
• 从 GitHub 或 TokRepo 找到一个感兴趣的 Skill
• 用 3 种方法之一安装到 ~/.claude/skills/
• 在对话中试试 /skill名 或直接描述需求自动触发
• 尝试按模板自己写一个简单的 Skill
• 把团队规范写成 Skill，放到项目 .claude/skills/ 里共享