Claude Code Skill的介绍与使用

Claude Skill

1. 概念介绍

1.1 什么是 Skill？

简单来说，Skill 就是 Claude Code 的专业技能包。Claude 自带了一些内置 Skill（如代码审查、安全检查），你也可以创建自己的自定义 Skill（如文档格式化），或者安装别人通过插件分享的 Skill。

你可以把它想象成手机上的"快捷指令"或者游戏里角色的"技能栏"------平时你和 Claude 对话是普通的聊天，而当你输入 /skill名称，或者用自然语言描述你的需求时，Claude 就会按照预设的流程去执行特定任务。

举个例子，同样是对代码审查的需求，有三种不同的方式：

• 普通对话：你说"这段代码有什么问题吗"，Claude 凭经验给出一些泛泛的建议
• 手动触发 Skill：你输入 /review，Claude 按照标准化审查流程，系统地检查代码质量、安全问题、潜在 bug 等
• 自动触发 Skill：你说"帮我做一下安全检查"，Claude 识别到这句话匹配了 security-review 的描述，自动启动安全审查流程------你不需要记得具体的命令名称

1.2 Skill 的作用

Skill 解决了几个痛点：

1. 提高效率：不用每次都写一大堆提示词，一个命令搞定
2. 结果一致：每次执行相同的 skill，走的是同一套流程，结果更可预期
3. 专业聚焦：每个 skill 只做一件事，效果比泛泛的对话要好
4. 可复用：一次配置，反复使用
5. 个性化定制：内置 Skill 覆盖通用场景，但每个项目都有独特需求。自定义 Skill 让你能把项目专属的工作流固化下来（比如团队的文档格式规范、特定的部署检查流程），无需每次重新描述

1.3 内置 Skill 与自定义 Skill

Claude Code 的 Skill 有三种来源：

来源	说明	典型用途
内置 Skill	程序自带，开箱即用，共 9 个	代码审查、安全检查、项目初始化等通用场景
自定义 Skill	自己编写，放在 ~/.claude/skills/ 或 .claude/skills/	团队专属工作流、个人常用任务
插件 Skill	通过 /plugin install 安装别人写好的 Skill	社区共享的专业技能（如文档处理、数据转换等）

三者的使用方式完全一样------都是输入 /skill名称 来调用。区别只在于来源和安装方式。内置 Skill 覆盖了常见开发场景（详见附录速查表），但实际开发中，你很可能会需要针对自己项目特点的专属 Skill，这时候自定义 Skill 就派上用场了。

具体如何创建自定义 Skill，见 [2.3 如何安装/创建自定义 Skill](#2.3 如何安装/创建自定义 Skill)；GitHub 开源 Skill 项目的详细介绍，见 [4. 笔者用到的 GitHub 开源 Skill 项目](#4. 笔者用到的 GitHub 开源 Skill 项目)。

---

2. 上手指南

2.1 如何查看已安装的 Skill

最简单的方式：在 Claude Code 中输入 /help，可以查看所有可用的命令和 skill。

另外，在每次对话的开头，Claude 也会收到系统提示，列出当前可用的 skill。比如本次对话中：

以下技能可供使用：
- update-config: 通过 settings.json 配置 Claude Code
- keybindings-help: 自定义键盘快捷键
- simplify: 审查代码质量并优化
- loop: 定时/循环执行任务
- claude-api: 构建、调试和优化 Claude API 应用
- init: 初始化 CLAUDE.md 文件
- review: 审查 Pull Request
- security-review: 安全审查
- fewer-permission-prompts: 减少权限提示

2.2 如何使用 Skill

基本语法 ：直接输入 / 加上 Skill 名称

/review
/simplify
/claude-api

带参数使用：有些 Skill 支持传入参数

/loop 5m /review    # 每 5 分钟执行一次 review

实际操作示例：

假设你想对当前代码进行安全审查：

你：/security-review
Claude：（启动安全审查流程，检查当前分支的所有待提交更改）

又比如你想看看代码能不能优化：

你：/simplify
Claude：（审查代码的复用性、质量和效率，然后自动修复发现的问题）

自定义 Skill 的调用方式和内置完全一样。比如本项目中有一个 document-format-skills：

你：/document-format-skills
Claude：（识别到这是一个文档格式处理技能，按照预设流程处理 .docx 文件）

就这么简单，不需要写复杂的提示词，一个斜杠命令就够了。

自动触发：除了手动输入斜杠命令，Claude 还会根据你的对话内容自动识别并调用 Skill。

原理是 Claude 将你说的话与每个 Skill 的 description 做匹配------匹配上就会自动调用，不需要你手动输入 /skill名称。例如：

你：帮我检查一下代码有没有安全问题
Claude：（识别到需求匹配 security-review 的 description，自动触发安全审查流程）

你：这份文档格式太乱了，帮我整理一下
Claude：（识别到需求匹配 document-format-skills 的 description，自动触发文档格式化）

几个要点：

• 自动触发是 Claude 基于语言理解的判断，不是精确的关键词匹配，所以偶尔可能匹配不上或误触发
• 如果你确定要用某个 Skill，手动输入 /skill名称 更精确可靠
• description 写得越好（明确描述触发条件），自动触发的准确率越高
• 将 user-invocable 设为 false 的 Skill 不会出现在斜杠菜单中，只能通过自动触发调用

2.3 如何安装/创建自定义 Skill

Skill 存放位置

自定义 Skill 放在两个位置之一：

级别	目录	说明
全局	~/.claude/skills/	所有项目都能用
项目级	项目根目录下 .claude/skills/	只有当前项目能用

创建一个自定义 Skill（三步走）

第 1 步：建目录

在 ~/.claude/skills/ 下新建一个文件夹，名字用小写字母加连字符（如 my-test）：

~/.claude/skills/
└── my-test/

第 2 步：写 SKILL.md

在 my-test/ 目录下创建 SKILL.md，格式如下：

---
name: my-test
description: This skill should be used when the user asks to "测试一下" or "检查某功能".
---

# 测试 Skill

1. 读取当前目录下的所有 `.py` 文件
2. 统计每个文件的行数
3. 输出一份汇总报告

就这么简单------YAML frontmatter 写上名称和触发描述，Markdown body 写具体要执行的步骤。

第 3 步：保存即生效

Claude Code 会自动扫描 ~/.claude/skills/ 和 .claude/skills/ 目录，保存后无需重启，热重载 立即生效。输入 /my-test 就能调用。

Frontmatter 常用字段说明

字段	必需	说明
name	是	Skill 名称，用小写字母+连字符
description	是	触发条件，写"什么时候该用这个 skill"
version	否	版本号
model	否	指定模型（sonnet/opus/haiku）
allowed-tools	否	限定可用的工具，如 Read, Write, Bash(git:*)
argument-hint	否	参数提示，如 [file-path]
user-invocable	否	是否出现在斜杠菜单中（默认 true）

写 description 的技巧：用第三人称写触发条件，比如 "This skill should be used when the user asks to '做某事'"。Claude 就是靠这个 description 来判断何时触发你的 Skill。

通过插件安装 Skill

除了自己写，还可以通过插件安装现成的 Skill：

/plugin install <插件名>

插件中包含的 Skill 会自动被识别，输入 /skills 就能看到。

---

1.3 进阶内容

1.3.1 Skill 的触发机制

Skill 有两种触发方式：

手动触发（斜杠命令）：

当你输入 /skill名称 时，Claude Code 会：

1. 识别这个命令是一个 Skill 调用
2. 加载该 Skill 的指令内容
3. 按照指令中定义的流程执行任务

自动触发（意图匹配）：

当你用自然语言描述需求时，Claude 会将你的话与每个 Skill 的 description 做匹配。如果匹配上，Claude 会自动调用对应的 Skill，不需要你手动输入斜杠命令。

这不是关键词匹配，而是 Claude 的语言理解能力在做判断。所以 description 字段承担了双重角色：

角色	说明
斜杠菜单展示	输入 / 时显示给用户的 Skill 说明
自动触发匹配	Claude 判断是否该调用这个 Skill 的依据

这也是为什么 1.2.3 中强调 description 要用"当用户做 X 时"这种触发条件式的写法------它直接影响自动触发的准确度。

另外，user-invocable 设为 false 的 Skill 不会出现在斜杠菜单中，只能通过自动触发使用。适合那些不需要用户主动调用、只在特定场景下自动生效的 Skill。

1.3.2 各 Skill 的使用场景速览

Skill	典型场景
/init	刚 clone 一个项目，想生成项目文档
/review	提了 PR，想让 Claude 帮忙审查
/simplify	代码写完了，想优化一下
/security-review	上线前的安全检查
/claude-api	开发 Claude API 相关应用
/update-config	想调整 Claude Code 的设置
/keybindings-help	想自定义快捷键
/loop	需要定时执行某个任务
/fewer-permission-prompts	权限提示太多想精简

以下为一些 GitHub 开源 Skill 项目（详见 1.4）：

项目	包含技能数	典型场景
humanizer-zh	1	去除 AI 写作痕迹，让文本更自然
document-format-skills	1	.docx 文档格式化（公文/学术/法律三种预设）
authropics-skills	17	Anthropic 官方技能：文档处理、视觉设计、开发工具、内容协作
superpowers	14	严谨的开发工作流：TDD、系统化调试、代码审查、计划执行

1.3.3 常见问题 FAQ

Q：输入 /skill名称 没有反应怎么办？

A：确认拼写是否正确。Skill 名称是小写字母，用连字符连接（如 security-review，不是 security_review）。

Q：Skill 和普通对话有什么区别？

A：普通对话是自由的交流，而 Skill 会按照预设的专业流程来工作，结果更系统、更全面。

Q：可以同时使用多个 Skill 吗？

A：每次对话中可以先后调用不同的 Skill，但不能在一条消息中同时激活多个。

Q：Skill 执行到一半能中断吗？

A：可以，按 Esc 或者发送新的消息打断即可。

Q：创建自定义 Skill 后需要重启 Claude 吗？

A：不需要。Claude Code 支持热重载，保存 SKILL.md 后立即生效。

Q：全局 Skill 和项目级 Skill 有什么区别？

A：全局 Skill 放在 ~/.claude/skills/，所有项目都能用；项目级 Skill 放在项目下的 .claude/skills/，只有当前项目能用。如果名称冲突，项目级优先。

Q：怎么查看所有已安装的 Skill？

A：输入 /skills 可以查看完整列表，包括内置的、自定义的和插件安装的。

Q：除了输入 /skill名称，还有别的方式触发 Skill 吗？

A：有。Claude 会根据你的对话内容自动匹配 Skill 的 description 来决定是否调用。比如你说"帮我做一下安全检查"，Claude 可能自动触发 /security-review。不过自动触发是 Claude 的判断，如果你确定要调用某个 Skill，手动输入更精确。

---

1.4 笔者用到的 GitHub 开源 Skill 项目

本节介绍从 GitHub 获取的一些开源 Skill 项目。这些项目涵盖了内容创作、办公文档处理、软件开发工作流等场景。

1.4.1 Humanizer-zh

来源： GitHub 社区 | 技能数： 1

去除文本中的 AI 生成痕迹，使文字听起来更自然、更像人类书写。基于维基百科"WikiProject AI Cleanup"维护的"AI 写作特征"指南。

检测的 24 种 AI 模式：

分类	典型模式
内容模式	过度强调意义/象征、夸大知名度报道、以 -ing 结尾的肤浅分析、宣传式语言、模糊归因、公式化的"挑战与展望"段落
语言模式	高频 AI 词汇（此外、至关重要、深入探讨、格局、织锦......）、系动词回避（用"作为/充当"代替"是"）、否定式排比、三段式法则过度使用、刻意换词、虚假范围
风格模式	破折号过度使用、粗体过度使用、内联标题+冒号列表、表情符号装饰、弯引号
交流模式	协作交流痕迹（"希望这对您有帮助"）、知识截止日免责声明、谄媚语气
填充词	冗长填充短语、过度限定、通用积极结论

核心理念： 去除 AI 痕迹只是一半工作，另一半是注入"灵魂"------有观点、变化节奏、承认复杂性、适当使用第一人称、允许一些"不完美"。

内置质量评分体系： 从直接性、节奏、信任度、真实性、精炼度 5 个维度打分（满分 50）。

---

1.4.2 document-format-skills

来源： GitHub 社区 | 技能数： 1

专门用于处理 .docx 文件的中文文档格式化工具链，内置 5 个 Python 脚本。

功能一览：

功能	对应脚本	说明
格式诊断	analyzer.py	分析标点混用、序号不统一、段落格式问题、字体混乱等
标点修复	punctuation.py	智能判断中英文环境，自动修复括号、引号、冒号、逗号等标点混用
格式统一	formatter.py	应用预设格式规范，自动调整页面、标题、正文、表格、页码
表格自动调整	formatter.py	根据内容自动优化列宽、对齐方式
页码规范化	formatter.py	添加奇偶页页码，统一格式

三种格式预设：

预设	适用场景	关键特征
official	中国公文（GB/T 9704-2012）	A4，仿宋_GB2312，28pt 固定行距
academic	学术论文	1.5 倍行距，英文用 Times New Roman
legal	法律文书	宋体，14pt 正文，1.5 倍行距

使用方式： 输入 /document-format-skills，Claude 会根据描述调用对应脚本。依赖 python-docx，通过 uv run --with python-docx 自动安装。

---

1.4.3 Anthropic 官方技能集（authropics-skills）

来源： Anthropic官方 | 技能数： 17

Anthropic 维护的官方 Skill 集合，覆盖从内容创作到开发工具的全方位场景。按用途可分为以下几类：

办公文档处理（3 个）

Skill	功能
docx	Word 文档全生命周期：创建（docx-js）、读取（pandoc/XML）、编辑（解包→修改→重新打包）、追踪修订、批注。核心约束：不要用 \n 换行，表格必须用 WidthType.DXA
pdf	PDF 一站式处理：合并/拆分（pypdf/qpdf）、提取文本和表格（pdfplumber）、创建（reportlab）、OCR（pytesseract）、加水印、加密
pptx	PPT 全流程：创建（pptxgenjs）、读取（markitdown）、编辑（XML 解包）、10 套配色方案和 8 种字体搭配的设计指南、质量检查

视觉与设计（4 个）

Skill	功能
algorithmic-art	用 p5.js 创作算法艺术：先撰写"算法哲学"文档，再生成交互式 HTML 可视化作品，支持种子随机和参数滑块
canvas-design	创建博物馆级静态视觉作品（海报/插画），输出 .png 或 .pdf，强调最小化文字和精湛的空间表达
frontend-design	打造高设计品质的前端界面，刻意避免 AI 通用美学，强调大胆的视觉方向、独特字体、渐变和纹理
theme-factory	10 套预制主题（Ocean Depths、Sunset Boulevard、Forest Canopy 等），每套含配色和字体搭配，可应用到任意素材

开发工具（5 个）

Skill	功能
claude-api	Claude API/Anthropic SDK 全面指南：支持 Python/TS/Java/Go/Ruby 等语言，覆盖 tool use、prompt caching、streaming、model 迁移
mcp-builder	创建高质量 MCP（Model Context Protocol）服务器的四阶段工作流：研究规划 → 实现 → 测试 → 评估
skill-creator	元技能：创建、修改、测试 Skill 的完整生命周期，包括测试用例、并行评估、定量评分和 HTML 审查界面
web-artifacts-builder	构建复杂的 claude.ai HTML artifacts（React 18 + Tailwind + shadcn/ui），打包为单个自包含 HTML
webapp-testing	用 Playwright 测试本地 Web 应用：元素发现、DOM 检查、截图、控制台日志

内容协作（4 个）

Skill	功能
brand-guidelines	Anthropic 品牌视觉规范：官方配色（深/浅/强调色）、字体（Poppins + Lora），用于统一素材风格
doc-coauthoring	三阶段协作文档写作流程：背景收集 → 逐节精修 → 读者测试（让新 Claude 实例回答问题验证可读性）
internal-comms	内部沟通写作：状态报告、领导层更新、公司通讯、FAQ、事故报告等，自动识别类型并路由到对应模板
slack-gif-creator	创建 Slack 优化的动画 GIF：内置 GIFBuilder 类、尺寸验证器、缓动函数、9 种动画模式（shake、pulse、bounce 等）

其他

Skill	功能
xlsx	电子表格处理：pandas 数据分析 + openpyxl 公式/格式化，遵循金融模型色彩规范（蓝色=硬编码、黑色=公式、绿色=跨表引用）

---

1.4.4 Superpowers 开发工作流技能集

来源： Jesse Weaver / obra| 技能数： 14

一套严谨的软件开发方法论 Skill 集合，将系统化的工程实践固化为 Claude Code 可执行的流程。核心理念是"纪律驱动开发"------用强制性规则替代随意的判断。

核心纪律（3 个）

Skill	核心铁律
test-driven-development	没有失败测试就没有生产代码。 严格红-绿-重构循环：先写最小失败测试 → 写最简实现 → 重构。如果代码先于测试存在，必须删除。
systematic-debugging	没有根因调查就没有修复。 四阶段流程：根因调查 → 模式分析 → 假设测试 → 实现修复。修复前先写失败测试。如果 3 次修复都失败，质疑架构。
verification-before-completion	没有验证证据就不声称完成。 必须在当前消息中运行验证命令并确认输出，才能说"测试通过"或"bug 已修复"。

工作流编排（5 个）

Skill	用途
brainstorming	任何创造性工作的硬性前置关卡：先设计再实现，连"太简单不需要设计"都是反模式。9 步清单：探索上下文 → 提问 → 提出方案 → 逐节审批 → 写设计文档 → 自审 → 用户审 → 转入实现
writing-plans	将设计规格转化为可执行计划：假设执行者零上下文，每个步骤 2-5 分钟粒度，不允许任何占位符（TBD/TODO），必须包含具体文件路径和测试方法
executing-plans	按计划逐步执行，每步标记完成，遇阻塞立即停止
subagent-driven-development	每个任务分配独立子代理执行，完成后进行规格审查+代码质量审查两轮检查。自动选择最低能力模型降低成本
dispatching-parallel-agents	面对 2+ 独立任务时并行派发子代理，每个代理聚焦单一问题域

代码质量（3 个）

Skill	用途
requesting-code-review	完成任务/合并前必须触发代码审查：获取 git SHA → 派发审查子代理 → Critical 立即修复、Important 推进前修复、Minor 记录延后
receiving-code-review	收到审查反馈后的响应纪律：先读→理解→对照代码验证→评估→再响应。禁止"你说得对！"式的表演性同意。如果审查者错了，用技术推理反驳。
finishing-a-development-branch	开发完成后呈现结构化选项：本地合并、推送创建 PR、保持原样、丢弃。检测环境（普通仓库/worktree/分离 HEAD）给出对应选项

环境与元技能（3 个）

Skill	用途
using-git-worktrees	启动功能开发前创建隔离工作区：优先使用原生工具，回退到 git worktree add，自动检测并运行项目初始化
using-superpowers	入口技能：定义如何发现和使用其他技能，只要有任何一个技能可能适用就必须调用，没有例外
writing-skills	用 TDD 方法论创建 Skill：测试用例 = 压力场景，生产代码 = SKILL.md。包含 Claude 搜索优化（CSO）规范和部署检查清单

---

附录

内置 Skill 速查表

Skill 名称	功能说明
update-config	通过 settings.json 配置 Claude Code（主题、权限、环境变量等）
keybindings-help	自定义键盘快捷键和 chord 绑定
simplify	审查代码的复用性、质量和效率，自动修复问题
fewer-permission-prompts	扫描常用操作，添加白名单减少权限确认弹窗
loop	定时或循环执行任务（如每 5 分钟检查部署状态）
claude-api	构建、调试和优化 Claude API / Anthropic SDK 应用
init	初始化 CLAUDE.md 文件，记录代码库文档
review	审查 GitHub Pull Request
security-review	对当前分支的待提交更改进行安全审查

GitHub 开源 Skill 项目速查表

Humanizer-zh（1 个技能）

Skill 名称	功能说明
humanizer-zh	去除 AI 写作痕迹：检测 24 种 AI 模式（过度象征、宣传语言、三段式、AI 词汇等），注入人类写作的灵魂和个性

document-format-skills（1 个技能）

Skill 名称	功能说明
document-format-skills	.docx 文档格式化工具链：格式诊断、标点修复、格式统一（支持公文/学术/法律三种预设）

Anthropic 官方技能集（authropics-skills，17 个技能）

Skill 名称	功能说明
algorithmic-art	用 p5.js 创作算法艺术，支持种子随机和交互参数探索
brand-guidelines	Anthropic 品牌视觉规范（配色 + 字体），用于统一素材风格
canvas-design	创建博物馆级静态视觉作品（海报/插画），输出 .png 或 .pdf
claude-api	Claude API / Anthropic SDK 全面指南，支持多语言和 model 迁移
doc-coauthoring	三阶段协作文档写作：背景收集 → 逐节精修 → 读者测试
docx	Word 文档全生命周期：创建、读取、编辑、追踪修订、批注
frontend-design	高品质前端界面设计，避免 AI 通用美学
internal-comms	内部沟通写作（状态报告、通讯、FAQ、事故报告等）
mcp-builder	创建高质量 MCP 服务器的四阶段工作流
pdf	PDF 一站式处理：合并、拆分、提取、创建、OCR、水印
pptx	PPT 全流程：创建、编辑、设计、质量检查
skill-creator	创建/修改/测试 Skill 的元技能，含定量评估和审查界面
slack-gif-creator	创建 Slack 优化的动画 GIF，含 9 种动画模式
theme-factory	10 套预制主题（配色 + 字体），可应用到任意素材
web-artifacts-builder	构建复杂 React+Tailwind+shadcn/ui 的 claude.ai HTML artifacts
webapp-testing	用 Playwright 测试本地 Web 应用
xlsx	电子表格处理：数据分析、公式、金融模型色彩规范

Superpowers 开发工作流技能集（14 个技能）

Skill 名称	功能说明
using-superpowers	入口技能：定义如何发现和使用其他技能
brainstorming	任何创造性工作的硬性前置设计关卡（9 步清单）
writing-plans	将设计规格转化为可执行计划（零上下文假设，2-5 分钟粒度）
executing-plans	按计划逐步执行，遇阻塞立即停止
subagent-driven-development	每个任务分配独立子代理，含规格审查+代码质量审查
dispatching-parallel-agents	2+ 独立任务并行派发子代理
test-driven-development	严格红-绿-重构循环，没有失败测试就没有生产代码
systematic-debugging	四阶段调试：根因调查 → 模式分析 → 假设测试 → 修复
verification-before-completion	没有验证证据就不声称完成
requesting-code-review	完成任务/合并前必须触发代码审查
receiving-code-review	收到审查反馈后的技术验证纪律，禁止表演性同意
finishing-a-development-branch	开发完成后呈现合并/PR/丢弃的结构化选项
using-git-worktrees	启动功能开发前创建隔离工作区
writing-skills	用 TDD 方法论创建 Skill，含 CSO 优化和部署检查清单

---

参考资料

• Claude Code 官方文档
• Anthropic 官网