我们在使用 Claude Code 的过程当中，是否经常会遇到重复给 AI 提供相同的提示词，不停的告诉 Claude 我自己的工作方式和代码标准，虽然在之前我们可以通过 slash command 或者 CLAUDE.md 文件来部分实现。但今天我要介绍的 Claude Skill 可以更好的帮你解决这个问题。

在我们进一步介绍 Claude Skills 之前，先来回顾一下 Claude 已经给我提供的扩展：

  • MCP（Model Context Protocol），这是 Claude 连接外部的协议，让 Claude 可以访问网络，文件，数据库等外部资源，通过 MCP 还可以调用浏览器自动化 Playwright 等。
  • Slash Commands 快捷命令，这是手动配置的快捷命令，通过 / 就能触发调用
  • Subagents 子代理，用来优化任务级别的工作流和上下文管理，通过可以自定义的系统提示词，工具以及单独的上下文窗口，就像是派生出一个你的分身去干具体的任务
  • Plugins 插件，自定义命令行，Agents，hooks，Skills，MCP servers 等，将这些内容都打包到插件中，可以通过 Plugin Marketplaces 快速集成

Agent Skills

在介绍 Claude Code Skills 之前首先要介绍一下 Claude 的 Agent Skills。Skills 是一组用来扩展 Claude 能力的模块，包括提示词，脚本，相关资源文件等等。

Agent Skills 可以用在任何 Claude 相关的产品，桌面客户端，Claude Developer Platform（API），Claude Code 等等产品。

Claude Code Skill 功能目前仅适用于 Pro，Max，Team 和 Enterprise 计划用户。

Skills

Claude 使用 Skills 来封装一组能力，Skills 本质上是磁盘上的一个文件夹，文件夹下可以保存完成特定任务所需要的文档（知识）和工具（脚本，工作流等）。

一个完整的 Claude Code Skill 通常包括以下部分：

  • SKILL.md 核心的定义文件，YAML 格式，包含了 Skill 的名字，描述，Markdown 编写的详细指令，指导 Claude 在特定场景下执行的动作
  • scripts 存放可执行 Python，Shell 脚本
  • references，参考文档，比如 API 文档，数据库定义 Schema，公司代码规范，政策等，Claude 会参考
  • assets，资源文件，包括 PPT 模板，Logo，项目脚手架等，Claude 如果使用该 Skill 会直接使用

Skills 的实际应用场景

Skills 可以自动化有固定流程和规范的重复性任务，比如让 Skill 自动评估代码质量，识别安全漏洞，确保代码按照最佳实践，或者让同一应用中所有设计符合主题配色，确保前端代码中使用的 Logo 都是符合品牌要求的，比如让 Skill 定期生成符合规范的报告等等。 我们可以将“Skills”认为是一个拥有专业技能的专家，一旦 Claude 认为我们这项任务可以交给这个专家，就会自动让这位专家称为你当前任务的顾问，更好的完成下达的指令。

Skills 是如何工作的？

在 Claude Code 启动时，会扫描所有可用的 Skills，查看其名称和描述， 判断这个 Skill 是否与当前的任务相关。只有当 Skill 和任务相关时，Claude 才会加载它。

  • 可组合：技能堆叠在一起。Claude 会自动识别需要的技能并协调它们的使用。
  • 可移植：技能在任何地方都使用相同的格式。构建一次，跨 Claude 应用程序、Claude 代码和 API 使用。
  • 高效：只在需要的时候加载需要的内容。
  • 强大：Skills 可以包括任务的可执行代码，传统编程比 token generation 更可靠。

Skills 的核心是为上下文窗口减负，通过层级递增的方式来匹配技能。官方将其称为 Progressive Disclosure（渐进式披露）的机制，通过层层递进的方式来扩大 Claude 的上下文，而不是一次性将所有的信息都放到上下文中。

  • 对于 Skills 的名字和描述，通常会在 Claude 启动时就存在上下文，通过提问 Claude 会快速扫描所有 Skills 描述，快速作出筛选，是否有合适的技能，通常只需要几百 Token，成本极低
  • 当 Claude 认为某个 Skill 技能可以用来解决当前的任务，才会去加载 SKILL.md 详细指令，通过指令来执行更具体的步骤和规则，通常会消耗更多的 Token
  • 最后一步，只有 SKILL.md 文章的指令中明确要求使用脚本或者读取参考文档时，Claude 才会去读取脚本文件和参考文档。

这样分层的设计，极大的节省了宝贵的上下文窗口，避免了一次性将所有的东西都放到上下文导致成本消耗极大的问题。

使用经验

Anthropic 一开始就发布了很多 Skills，可以从这个 skills 项目中汲取灵感。

  • docx - 创建正确的 Word 文档
  • pptx - 带有布局、图表等的实际 PowerPoint 文件
  • xlsx - 带有真实公式的 Excel
  • pdf - 填充和操作
  • canvas-design - PNG/PDF 中的视觉布局
  • brand-guidelines - 保持一切符合品牌规范
  • algorithmic-art - 使用 p5.js 的生成艺术
  • slack-gif-creator - 制作适合 Slack 约束的 GIF

Skill Creator

Anthropic 创造了一个为用户构建 Skills 的 Skill，叫做 Skill Creator，只需要使用简单的语言描述你想做什么，就会自动为你编写 SKILL.md 文件。

通过插件市场安装

可以使用如下的命令来添加插件市场。在 Claude Code 下执行

/plugin marketplace add anthropics/skills

输入 /plugin 可以进行安装卸载等管理。

可以直接通过如下的命令来快速安装 Skills

/plugin install document-skills@anthropic-agent-skills

官方提供了两个插件

  • document-skills：文档相关，可以处理 Excel、Word、PPT、PDF 等文档。
  • example-skills：示例技能包 ，可以处理技能创建、MCP 构建、视觉设计、算法艺术、网页测试、Slack 动图制作、主题样式等。

安装成功之后，需要重启 Claude Code 才能加载。

创建自己的 Skill

我们可以使用官方的 Skill Creator 的 Skill 来创建 SKILL.md 文件，当然也可以自己手动创建文件夹和文件。这里就带大家从零开始构建一个 Skills。

如果要创建一个可以在任何项目中使用的 Skill，将文件存储在 ~/.claude/skills/ 目录下。

mkdir -p ~/.claude/skills/my-skill-name

如果只想在项目中使用，存储在 .claude/skills/ 目录下

mkdir -p .claude/skills/my-skill-name

Skill 的文件结构

.claude/skills/
├── code-reviewer/
│   ├── SKILL.md
│   ├── manifest.json
│   └── validators.py
├── csv-auditor/
│   ├── SKILL.md
│   └── validator_script.py

编写 SKILL.md

SKILL.md 文件定义了技能的名字和描述，文件头 YAML 格式，以及 Markdown 正文。

---
name: code-reviewer
description: 评估代码质量、安全漏洞、性能问题和最佳实践遵守情况
---

# 代码审查 Skill

## 职责

1. 检查代码结构和可读性
2. 识别安全漏洞

说明

  • name 是必须的，并且只支持小写字母，数字和连字符，最多 64 字符
  • description 简要描述技能的作用，以及什么时候使用该技能，最多 1024 个字符

description 字段非常重要，Claude 会根据此字段来判断何时使用 Skills。可以参考 最佳实践

可执行脚本

当 Skill 认为需要执行代码时，会根据 Skill 的定义来调用对应的脚本文件。

支持文件

和上面提到的一样，技能文件夹下可以包括其他的资源文件

my-skill/
├── SKILL.md (required)
├── reference.md (optional documentation)
├── examples.md (optional examples)
├── scripts/
│   └── helper.py (optional utility)
└── templates/
    └── template.txt (optional template)

这些文件可以直接在 SKILL.md 文件中引用，比如

    For advanced usage, see [reference.md](reference.md).

    Run the helper script:
    ```bash
    python scripts/helper.py input.txt
    ```

Claude 只有在需要的时候才会读取这些文件。

allowed-tools 限制工具访问权限

可以使用 allowed-tools 字段来限制 Claude 在技能激活时可以使用的工具。

---
name: safe-file-reader
description: Read files without making changes. Use when you need read-only file access.
allowed-tools: Read, Grep, Glob
---

# Safe File Reader

This Skill provides read-only file access.

## Instructions
1. Use Read to view file contents
2. Use Grep to search within files
3. Use Glob to find files by pattern

Skill 激活之后，Claude 无需请求权限即可使用指定的工具（比如读取，搜索，全局搜索）。

查看并验证可用 Skills

Claude 会从如下的文件获取可用的 Skills

  • 全局 ~/.claude/skills
  • 项目 .claude/skills
  • 插件 Skills，和插件绑定

可以直接问 Claude

What Skills are available?
List all available Skills?

如果 Skills 没有被 Claude 调用，首先要检查的就是 description 中的描述是否更具体，以及 SKILL.md 文件格式是否正确。

其他的 Skills

Skills vs MCP

MCP 要解决的问题是让 Claude 突破本地的限制，访问外部的资源，它本质上是定义了一个访问通信协议。

Skills 并不是用来替代 MCP，而是可以组合使用，Skills 是对 Agent 能力的封装，解决的是如何让 Claude 思考和作出行为。Skills 定义了知识，工作流，脚本工具。在 Skills 中也可以定义 MCP 服务来解决任务。通过 Skills 可以让通用的模型变成某个特定领域的专家。

Skills 是把特定任务的工作流转成可被自动调用的模块，而 MCP 则是将外部工具，文档，数据源等转成标准化可被 AI 调用的接口。

Skills 的重点在于完成任务，更像是一本操作手册，当遇到某项具体任务时，可以按照步骤，最佳实践以及注意事项来完成任务，更关注过程和方法。MCP 的重点则是在于「连接」，以前 AI 可能无法读取外部的数据，MCP 定义了连接外部的方式，可以让 AI 也可以读取操作外部数据（网络，文件，数据库等）MCP 关注的是实现访问和具体的行为。

在 Token 使用上也存在一些差异，Skills 通过渐进式方式提升了 Token 使用效率，而 MCP 的实现可能会不小心在提示词中去读取庞大的参考文档或数据定义，这会大量地消耗 Token。

Skills vs Clash Command

Skills 由模型自动调用，Claude 会根据 Skill 描述和具体的任务自动匹配并使用 Skills，无需人工介入，Slash Commands 则是由用户主动发起。

Skills 带来的启发

Skills 给 Claude 带来了更多的扩展性，组合性也更好，可以任意地将多个技能组合在一起完成一个工作流，比如根据设计文档，生成模板代码，测试代码，代码审查，提交代码等。

  • 从写提示词变成设计工作流，将提示词工程变成工作流工程，关注输入结构，工具链，状态管理和容错
  • 从一次性产物变成可维护系统，每个 Skill 都是可版本化的流程模块，像软件一样测试，发布和回滚
  • 从智能补充，到智能基建，将 Skills 视为组织的基础设施，承载标准， 权限，日志和治理。
  • [[AutoGen]]
  • [[CrewAI]]
  • [[LangGraph]]
  • [[Skill Seeker]]