让 Claude 学会你的工作方式——自动匹配专业知识，无需记忆命令
Skill 是一个 Markdown 文件，教 Claude 如何完成特定任务。当你的请求匹配 Skill 的用途时，Claude 会自动应用它。
| 方式 | 用途 | 触发时机 | 适用场景 |
|---|---|---|---|
| Skills | 给 Claude 专业知识 | Claude 自动选择 | 代码审查标准、提交信息规范 |
| Slash Commands | 可复用提示词 | 手动输入 /command | 部署流程、代码生成模板 |
| CLAUDE.md | 项目级指令 | 每次对话加载 | 项目规范、技术栈约定 |
| MCP Servers | 连接外部工具 | 按需调用 | 数据库、API、文件系统 |
无需记忆命令，Claude 根据你的请求自动选择合适的 Skill
核心信息始终加载，详细文档按需加载，节省 token
通过 allowed-tools 限制 Skill 可用的工具，确保安全
当你发送请求时，Claude 经过以下步骤找到并使用相关的 Skills
例如："帮我看看这个 PR 的代码质量"
Claude 分析请求，在所有 Skills 中查找匹配的 description
SKILL.md 加载到上下文，支持文件按需加载
Claude 按照 Skill 的指令生成符合标准的响应
组织级设置路径
组织内所有用户
~/.claude/skills/ 你个人，所有项目
.claude/skills/ 仓库内所有协作者
随插件打包
安装该插件的任何人
如果两个 Skills 同名，优先级高的会覆盖优先级低的
创建 Skill 只需要一个 SKILL.md 文件，包含元数据和指令
---
name: your-skill-name
description: 简述 Skill 的作用和使用场景 (Claude 用它来决定何时应用)
allowed-tools: Read, Grep, Glob # 可选：限制工具权限
license: Complete terms in LICENSE.txt # 可选：许可证信息
---
# Your Skill Name
## Instructions
提供清晰、分步的指导给 Claude。
## Examples
展示具体的使用示例。name Skill 名称，只能用小写字母、数字和连字符（最多64字符）
description Skill 的作用和使用场景（最多1024字符）
这是 Claude 匹配的关键！
allowed-tools Skill 激活时 Claude 可无需权限使用的工具
model Skill 激活时使用的模型（如 claude-sonnet-4-20250514）
license 许可证信息（如 "Complete terms in LICENSE.txt"）
my-skill/
├── SKILL.md
└── LICENSE.txt # 可选适合简单任务、单一目的
my-skill/
├── SKILL.md # 概览和快速开始
├── LICENSE.txt # 许可证
├── reference.md # 详细 API 文档
├── examples.md # 使用示例
└── scripts/
└── helper.py # 工具脚本（零上下文执行）支持文件按需加载，节省 token
遵循官方最佳实践，创建高质量、可维护的 Skills
SKILL.md 应 < 500 行
核心信息放在 SKILL.md，详细内容放到支持文件。保持主文件简洁，确保快速加载和易于维护。
SKILL.md - 核心指令 + 快速开始
reference.md - 完整 API 文档
examples.md - 详细使用示例
详细内容按需加载，节省 token 使用的核心策略。
Anthropic 在 GitHub 上维护了一个官方 Skills 仓库，包含 16 个生产级 Skills
官方 Skills 仓库 - 生产级参考实现
使用 p5.js 创建算法艺术
高质量前端界面设计
MCP 服务器开发指南
创建高质量 Skills
PDF 处理完整工具包
Word 文档处理
PowerPoint 演示文稿
Excel 表格处理
Anthropic 品牌规范
Canvas 图形设计
主题样式生成器
复杂 HTML Artifacts
文档协作工作流
内部沟通模板
所有官方 Skills 使用 MIT 许可证，允许自由使用、修改和分发。
Complete terms in LICENSE.txt
欢迎社区贡献！遵循官方仓库的贡献准则。
从简单到复杂，覆盖常见使用场景
单文件 Skill - 自动生成规范的 Git 提交信息
---
name: generating-commit-messages
description: 从 git diff 生成清晰的提交信息。使用当用户需要写提交信息或查看暂存的更改时。
---
# Generating Commit Messages
## Instructions
1. 运行 `git diff --staged` 查看变更
2. 建议包含以下内容的提交信息：
- 50字符以内的摘要
- 详细描述
- 受影响的组件
## Best Practices
- 使用现在时态
- 解释"做什么"和"为什么"，而不是"怎么做"只需说："帮我写个提交信息" 或 "看看我暂存了什么"
多文件 Skill - 支持文档、脚本、权限控制
---
name: pdf
description: 从 PDF 提取文本和表格，填充表单，合并文档。处理 PDF 文件时使用，或当用户提及 PDF、表单、文档提取时。
allowed-tools: Read, Bash(python:*)
---
# PDF Processing Guide
## Overview
本指南涵盖基本的 PDF 处理操作。高级功能见 reference.md，表单填写见 forms.md。
## Quick Start
```python
from pypdf import PdfReader
reader = PdfReader("document.pdf")
text = "".join(page.extract_text() for page in reader.pages)
```
## Additional Resources
- 表单字段映射见 forms.md
- API 详细信息见 reference.mdpdf/
├── SKILL.md
├── forms.md
├── reference.md
└── scripts/企业级 Skill - 定义团队代码审查规范
---
name: team-code-review
description: 按照团队标准审查代码质量。检查错误处理、类型安全、性能优化、安全性。使用当用户要求代码审查、PR 审查或质量检查时。
allowed-tools: Read, Grep, Glob
---
# Team Code Review Standards
## Review Checklist
1. **错误处理**：所有可能失败的操作都有 try-catch
2. **类型安全**：TypeScript 严格模式，无 any 类型
3. **性能**：无不必要的渲染，优化大列表
4. **安全**：无 XSS/SQL 注入风险，验证输入
5. **可读性**：命名清晰，适当注释
## Output Format
按优先级输出问题：
- 🔴 严重：安全漏洞、崩溃风险
- 🟡 警告：性能问题、代码异味
- 💡 建议：最佳实践、可读性只需说："审查这个 PR" 或 "检查代码质量"
基于官方 Skills 分析的实战准则
description 是 Claude 匹配的关键信号
❌ 模糊： Helps with documents
✅ 精确： Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
保持 SKILL.md 轻量，详细内容放单独文件
SKILL.md: 核心指令 + 快速开始
reference.md: 完整 API 文档
examples.md: 详细示例
使用 allowed-tools 保护安全边界
只读 Skill: allowed-tools: Read, Grep, Glob
数据处理: allowed-tools: Bash(python:*)
脚本执行只加载输出，不加载代码
scripts/validate.py - 执行但不读取
只有输出消耗 token，结果可靠
原因：description 太模糊，无法匹配
解决：包含具体动作和触发关键词，如 "从 PDF 提取文本、填充表单、合并文档"
检查：
~/.claude/skills/my-skill/SKILL.mdclaude --debug 查看错误原因：description 太相似
解决：用具体触发词区分，如 "销售数据 Excel 分析" vs "日志文件分析"
常用命令和路径
Personal: ~/.claude/skills/
Project: .claude/skills/
claude --debug # 查看加载错误
"What Skills available?" # 列出 Skills
[动作清单] + [触发场景] + [使用时机]
SKILL.md (必需，大写)