Anthropic 官方 Skills 介绍与使用指南
# 一、什么是 Skills
Skills 是 Claude Code 的"专业技能包"。每个 Skill 本质上是一个包含结构化指令的 Markdown 文件（SKILL.md），它告诉 AI 在特定场景下应该如何行动。
本质：
Skill = Prompt（领域知识）+ Tool（执行工具）+ Workflow（标准流程）
1
核心价值：
| 价值 | 说明 |
|---|---|
| 标准化 | 确保 AI 输出符合专业规范，避免每次手动描述流程 |
| 可复用 | 一次编写，跨项目、跨会话反复使用 |
| 自动触发 | Claude 根据对话内容自动判断是否需要调用某个 Skill |
| 零部署 | 纯文本文件，无需编译，放入目录即生效 |
工作机制：
1. Claude Code 启动时加载所有 Skill 的元数据（name + description）
2. 用户输入问题
3. Claude 根据 description 自动判断是否匹配某个 Skill
4. 匹配成功 → 按需加载 SKILL.md 正文 → 按照指令执行
1
2
3
4
2
3
4
# 二、官方 Skills 仓库
Anthropic 维护了一个官方 Skills 仓库：anthropics/skills (opens new window)（126K+ Stars）
该仓库包含 17 个官方 Skill，涵盖创意设计、办公文档、开发工程、协作沟通四大领域。
快速安装全部官方 Skills：
npx skills add anthropics/skills -y
1
# 三、Skills 快速选择指南
| 你的需求 | 推荐 Skill | 安装命令 |
|---|---|---|
| 处理 PDF/Word/Excel/PPT | pdf / docx / xlsx / pptx | npx skills add anthropics/skills -y |
| 设计网页 UI | frontend-design + theme-factory | npx skills add anthropics/skills -y |
| 构建 React 组件 | web-artifacts-builder + frontend-design | npx skills add anthropics/skills -y |
| 开发 MCP 服务器 | mcp-builder | npx skills add anthropics/skills -y |
| 创建品牌视觉 | canvas-design + brand-guidelines | npx skills add anthropics/skills -y |
| 生成 Slack 表情 | slack-gif-creator | npx skills add anthropics/skills -y |
| 编写协作文档 | doc-coauthoring | npx skills add anthropics/skills -y |
| 自动化测试 Web 应用 | webapp-testing | npx skills add anthropics/skills -y |
# 四、Skills 分类总览
# 4.1 创意与设计类
| Skill | 用途 | 触发场景 |
|---|---|---|
| algorithmic-art (opens new window) | 使用 p5.js 创建生成艺术 | 创建交互式视觉效果、粒子系统、分形动画 |
| canvas-design (opens new window) | 输出高质量视觉作品 | 创建海报、杂志级设计、信息图表 |
| slack-gif-creator (opens new window) | 生成 Slack 动态 GIF | 制作 Slack 动画表情、加载动画 |
| theme-factory (opens new window) | 10 套专业配色方案 | 配色方案、字体搭配建议 |
| brand-guidelines (opens new window) | Anthropic 品牌规范 | 使用官方品牌色、字体规范 |
| frontend-design (opens new window) | 生产级前端 UI 设计 | 构建高质量、非模板化的前端界面 |
# 4.2 办公文档类
| Skill | 用途 | 触发场景 |
|---|---|---|
| docx (opens new window) | Word 文档处理 | 创建/编辑 Word 文档、表格、修订模式 |
| pdf (opens new window) | PDF 文件处理 | 提取文本/表格、合并 PDF、OCR、表单处理 |
| pptx (opens new window) | PowerPoint 演示文稿 | 创建幻灯片、视觉 QA、排版优化 |
| xlsx (opens new window) | Excel 电子表格 | 处理复杂表格、动态公式、财务模型 |
# 4.3 开发与工程类
| Skill | 用途 | 触发场景 |
|---|---|---|
| web-artifacts-builder (opens new window) | React 交互组件构建 | 使用 React + Tailwind + shadcn/ui 构建组件 |
| claude-api (opens new window) | Claude API 开发指南 | 调用 Claude API、模型选择、流式输出 |
| mcp-builder (opens new window) | MCP 服务器构建 | 创建 Model Context Protocol 服务器 |
| skill-creator (opens new window) | 新 Skill 开发辅助 | 创建和迭代新 Skill、评估测试 |
| webapp-testing (opens new window) | 浏览器自动化测试 | 使用 Playwright 测试 Web 应用 |
# 4.4 协作与沟通类
| Skill | 用途 | 触发场景 |
|---|---|---|
| doc-coauthoring (opens new window) | 协作文档编写 | 多人协作写文档、多轮打磨 |
| internal-comms (opens new window) | 企业内部通讯 | 新闻简报、FAQ、事故报告、3P 更新 |
# 五、常用 Skills 详解
# 5.1 PDF 处理 Skill
核心能力：
| 能力 | 依赖库 |
|---|---|
| 提取文本和表格 | pdfplumber |
| 合并/旋转/加密 PDF | pypdf |
| 生成新 PDF | reportlab |
| OCR 识别扫描件 | pytesseract |
| 填写和提取表单 | pypdf |
使用示例：
用户：帮我从这份 PDF 报告中提取表格数据并保存为 CSV
AI：（自动应用 pdf skill → 使用 pdfplumber 提取 → 输出 CSV）
1
2
2
# 5.2 Excel 处理 Skill
核心能力：
- 强制动态公式 — 禁止硬编码数值，所有计算必须使用公式引用
- 自动重算机制 — 修改源数据后自动更新关联单元格
- 颜色编码规范 — 蓝色=输入、黑色=公式、绿色=外部引用（财务建模标准）
- 数据验证 — 自动添加下拉列表、范围检查等验证规则
使用示例：
用户：帮我创建一个财务预测模型
AI：（自动应用 xlsx skill → 动态公式 + 颜色编码 + 数据验证）
1
2
2
# 5.3 PowerPoint 创建 Skill
核心能力：
- XML 级精确编辑 — 直接操作 OOXML，实现像素级控制
- 排版规范强制 — 标题 ≥28pt，正文 ≥18pt，严格对齐网格
- 视觉 QA 流程 — 生成后自动截图检查，发现问题主动修正
- 粗体调色板 — 使用高对比度配色，拒绝灰色系低对比方案
使用示例：
用户：帮我做一个产品发布会的 PPT
AI：（自动应用 pptx skill → 遵循视觉规范 → 截图自检）
1
2
2
# 5.4 前端设计 Skill
核心能力：
- 禁用模板化设计 — 不使用通用模板和默认系统字体
- 大胆排版 — 非对称布局、超大标题、强视觉层次
- CSS 动画 — 交互动效、过渡动画、微动效
- 生产级标准 — 响应式、无障碍访问、语义化 HTML
使用示例：
用户：帮我设计一个现代化的登录页面
AI：（自动应用 frontend-design skill → 避免"AI 味"设计 → 生产级代码）
1
2
2
# 5.5 MCP 服务器构建 Skill
核心能力：
- 四阶段流程 — 研究（了解 API）→ 实现（编写 Server）→ 测试（验证功能）→ 评估（质量检查）
- 全面 API 覆盖 — 不遗漏目标服务的可用接口
- 工具注解规范 — 每个 Tool 必须有清晰的 name、description 和参数定义
使用示例：
用户：帮我创建一个连接 Notion 的 MCP 服务器
AI：（自动应用 mcp-builder skill → 研究 Notion API → 实现 → 测试 → 评估）
1
2
2
# 六、如何安装 Skills
# 6.1 从官方仓库安装
# 克隆官方仓库
git clone https://github.com/anthropics/skills.git
# 将所需 skill 复制到全局目录
cp -r skills/skills/pdf ~/.claude/skills/
# 或复制到项目目录
cp -r skills/skills/pdf .claude/skills/
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 6.2 创建项目本地 Skill
# 在项目根目录创建
mkdir -p .claude/skills/my-skill
# 创建 SKILL.md
cat > .claude/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: 描述这个技能做什么，何时使用
---
# 技能指令内容
## 工作流程
1. 第一步
2. 第二步
EOF
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 6.3 创建全局 Skill
全局 Skill 对所有项目生效：
mkdir -p ~/.claude/skills/my-global-skill
# 然后创建 SKILL.md（结构同上）
1
2
2
# 6.4 Skill 的作用域
| 位置 | 作用域 | 适用场景 |
|---|---|---|
.claude/skills/ | 当前项目 | 项目特定的部署流程、代码规范 |
~/.claude/skills/ | 所有项目 | 通用能力（PDF 处理、代码审查） |
# 七、Skill 文件结构
# 7.1 目录结构
skill-name/
├── SKILL.md # 必须 — 主指令文件
├── reference.md # 可选 — 详细 API 参考
├── examples.md # 可选 — 使用示例
└── scripts/ # 可选 — 辅助脚本
└── helper.py
1
2
3
4
5
6
2
3
4
5
6
# 7.2 SKILL.md 结构
每个 Skill 的核心是 SKILL.md 文件：
---
name: skill-name
description: 简洁描述做什么 + 何时触发。Use when ...
---
# 技能名称
## 快速开始
核心指令和约束条件
## 工作流程
分步操作说明
## 规则
必须遵守的规范
## 示例
输入/输出示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 7.3 Description 编写要点
Description 决定了 Claude 何时自动触发 Skill，是最关键的字段。
好的 description：
description: >
Extract text and tables from PDF files, fill forms, merge documents.
Use when working with PDF files or when the user mentions PDFs,
forms, or document extraction.
1
2
3
4
2
3
4
编写原则：
| 原则 | 说明 |
|---|---|
| 包含 WHAT | 这个 Skill 能做什么 |
| 包含 WHEN | 什么情况下应该触发 |
| 触发关键词 | 列出用户可能使用的关键词 |
| 第三人称 | 使用 "Extract..." 而非 "I extract..." |
# 八、使用场景示例
| 场景 | 用户需求 | 自动应用的 Skills |
|---|---|---|
| 文档处理 | 处理合同 PDF，提取条款并生成 Word 总结 | pdf → 提取文本和表格docx → 整理为 Word 文档 |
| 前端开发 | 做一个专业美观的数据仪表盘 | frontend-design → UI 布局与视觉风格web-artifacts-builder → React 交互组件theme-factory → 专业配色方案 |
| 演示文稿 | 做季度汇报 PPT，数据在 Excel 里 | xlsx → 读取和分析数据pptx → 创建演示文稿并嵌入图表 |
| MCP 开发 | 创建连接 GitHub 的 MCP 服务器 | mcp-builder → 研究/实现/测试/评估claude-api → API 最佳实践参考 |
| 品牌设计 | 为公司官网设计视觉规范 | brand-guidelines → 品牌规范参考canvas-design → 高质量视觉输出theme-factory → 配色与字体方案 |
| 自动化测试 | 给 Web 应用添加端到端测试 | webapp-testing → Playwright 测试脚本web-artifacts-builder → 测试用例可视化报告 |
# 九、自定义 Skill 开发
# 9.1 代码评审 Skill 示例
---
name: code-review
description: >
Review code for quality, security, and maintainability.
Use when reviewing pull requests, code changes, or when
the user asks for a code review.
---
# Code Review
## 评审检查清单
- [ ] 逻辑正确，处理边界情况
- [ ] 无安全漏洞（SQL 注入、XSS、命令注入等）
- [ ] 符合项目代码规范
- [ ] 函数职责单一，不超过 50 行
- [ ] 错误处理完善，不吞异常
- [ ] 测试覆盖充分
## 输出格式
### Critical（必须修复）
阻断性问题：安全漏洞、数据丢失风险、逻辑错误
### Suggestion（建议改进）
代码质量问题：命名不清、重复代码、缺少注释
### Nitpick（可选优化）
风格偏好：格式调整、微小重构
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 9.2 部署 Skill 示例
---
name: deploy-github-pages
description: >
Build and deploy VuePress site to GitHub Pages.
Use when the user asks to deploy, publish, or release the website.
---
# Deploy to GitHub Pages
## 部署流程
1. 检查 git 工作区是否干净
2. 运行 `npm run build` 构建静态文件
3. 检查构建输出是否有错误
4. 运行 `npm run deploy` 或 `bash deploy.sh`
5. 验证部署结果
## 注意事项
- 构建前确保所有依赖已安装
- 确认 CNAME 文件配置正确
- 构建失败时先检查 markdown 语法错误
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 十、最佳实践
# 10.1 保持简洁
SKILL.md控制在 500 行以内- 详细参考内容放在
reference.md - 使用示例放在
examples.md
# 10.2 渐进式披露
将内容分层，核心指令在主文件，细节在辅助文件：
## 快速开始
[核心指令 — Claude 首先读取这部分]
## 详细参考
参见 [reference.md](reference.md)
## 更多示例
参见 [examples.md](examples.md)
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 10.3 避免常见错误
| 错误 | 正确做法 |
|---|---|
| 指令过于笼统 | 提供具体的步骤和约束条件 |
| 提供太多可选方案 | 给出默认方案，特殊情况再提供替代 |
| description 缺少触发词 | 明确列出用户可能使用的关键词 |
| 使用 Windows 路径 | 使用 scripts/helper.py 而非 scripts\helper.py |
| 包含时间敏感信息 | 使用"当前方法"和"旧方法（已弃用）" |
| 术语不一致 | 全文使用统一术语 |
# 10.4 测试与迭代
开发新 Skill 后，建议通过以下方式验证：
- 直接触发 — 使用
/skill-name命令手动触发，检查是否按预期执行 - 自动触发 — 用自然语言描述需求，验证 Claude 能否正确匹配 Skill
- 边界测试 — 测试模糊描述是否仍能触发，不相关描述是否不会误触发
# 十一、资源链接
# 官方资源
- Anthropic 官方 Skills 仓库 (opens new window) — 17 个官方 Skill 源码（126K+ Stars）
- Claude Code 官方文档 (opens new window) — Skills 使用说明
# 社区生态
- skills.sh 技能市场 (opens new window) — 社区 Skills 搜索与安装平台
- Vercel Agent Skills (opens new window) — Vercel 官方 React 技能包（25K+ Stars）
- Obsidian Skills (opens new window) — Obsidian 知识管理技能包（27K+ Stars）
编辑 (opens new window)
上次更新: 2026/04/30, 23:46:02