Claude Code Skills 入门教程

1. 引言

Anthropic 推出的 Claude Skills 是一项革命性的功能，旨在将 Claude AI 从一个通用对话助手转变为一个能够执行特定、复杂任务的专业代理。Skills 允许用户将专业知识、工作流程和可执行代码打包成可复用的模块，极大地提升了 Claude 在自动化、标准化和效率方面的表现。

2. Claude Skills 核心概念

2.1 什么是 Claude Skills？

Claude Skills 是一个包含指令、脚本和资源的文件夹结构，Claude AI 可以在需要时动态加载这些内容，以提升其执行特定任务的能力。它将 AI 从“会聊天”升级为“会干活”，使其能够以标准化、自动化和可复用的方式完成任务。

核心特点：

• 可组合性 (Composable)： 多个 Skills 可以像积木一样组合起来，Claude 会自动判断需要哪些 Skills 并协调它们的使用。
• 可移植性 (Portable)： Skills 在 Claude 应用、Claude Code 和 API 中使用相同的格式，一次构建，多处复用。
• 高效性 (Efficient)： Claude 只在任务相关时按需加载所需信息和文件，避免上下文窗口过载，减少 Token 消耗。
• 强大性 (Powerful)： Skills 可以包含可执行代码，用于那些传统编程比 Token 生成更可靠的任务，确保确定性和一致性。

2.2 Skills 如何工作：渐进式披露 (Progressive Disclosure)

Skills 的设计核心是“渐进式披露”，确保了上下文窗口的高效利用。加载过程分为三层：

1. 元数据层 (Metadata)： Claude 启动时会加载所有已安装 Skills 的 name 和 description。这部分信息非常简短，让 Claude 知道有哪些技能可用以及它们的作用。
2. 核心指令层 (SKILL.md)： 当用户的请求与某个 Skill 的描述匹配时，Claude 才会加载该 Skill 的核心文件 SKILL.md 的全部内容。这里包含了详细的工作流程和指南。
3. 资源层 (Bundled Resources)： 如果 SKILL.md 中引用了其他文件（如脚本、参考文档或模板），Claude 会在需要时才去读取这些具体文件。可执行脚本甚至可以直接运行而无需加载到上下文中。

2.3 Skills 与其他 Claude 功能的对比

4. 在 Claude Code 中创建你的第一个 Skill

让我们创建一个简单的“品牌化幻灯片大纲生成器” Skill，并在 Claude Code 中使用它。

步骤 1：准备工作

• 确保你已经安装了 Claude Code 桌面应用。
• 确保你的 Claude 账户是付费套餐（Pro, Max, Team, Enterprise）。

步骤 2：创建 Skill 文件夹和文件

在你的电脑上，创建一个名为 branded-slide-maker 的文件夹。在该文件夹内，创建一个名为 SKILL.md 的文件。这部分操作与之前相同。

步骤 3：编写 SKILL.md

打开 SKILL.md 文件，并粘贴以下内容：

---
name: "branded-slide-maker"
description: "当用户请求创建小型品牌幻灯片时，使用此技能创建包含标题、议程、4-8个内容页和结尾的简短大纲。"
---

# 品牌化幻灯片大纲生成器

## 指令
- 从用户处收集输入信息：`deck_title` (标题), `audience` (观众), `purpose` (目的), `slide_count` (幻灯片数量, 4-8张)。
- 遵循风格指南：标题清晰，要点简洁（每张幻灯片不超过5个要点），保持一致的品牌口吻。
- 遵循结构：
  1. 标题页 (包含标题和副标题)
  2. 议程页 (列出主要部分)
  3. 内容页 (幻灯片 1-N，每张都有标题和要点)
  4. 结尾页 (包含总结和下一步行动)

## 示例
- **输入:** "为内部利益相关者创建一个关于产品更新的6张幻灯片。"
- **输出:** 一个包含6张幻灯片的大纲，标题清晰，要点精炼。

步骤 4：安装 Skill 到 Claude Code

与网页版不同，Claude Code 通过本地文件夹来加载个人技能，无需打包上传。

1. 找到 Claude Code 的技能目录。通常位于你的用户主目录下的 ~/.claude/skills/。
   • 在 Windows 上，路径可能是 C:\Users\YourUsername\.claude\skills\
   • 在 macOS/Linux 上，路径是 ~/.claude/skills/
2. 如果 .claude 或 skills 文件夹不存在，请手动创建它们。
3. 将你创建的 branded-slide-maker 文件夹整个移动或复制到 ~/.claude/skills/ 目录下。

安装后的目录结构应如下所示：

~/.claude/
└── skills/
    └── branded-slide-maker/
        └── SKILL.md

4. 重启 Claude Code 以确保它能加载新安装的 Skill。

步骤 5：测试 Skill

现在，打开 Claude Code，在对话框中输入以下提示：

Claude Code 应该会识别到你的请求，并在其思考过程中显示它正在加载并使用本地的 branded-slide-maker skill，然后生成一个符合你在 SKILL.md 中定义的结构和风格的大纲。

5. 核心要点与最佳实践

• Skills 与 MCP 的协同： Skills 教会 Claude 如何工作，而 MCP 为 Claude 提供连接外部工具的能力。最强大的应用场景是将两者结合：使用 Skill 定义一个工作流，该工作流通过 MCP 调用外部 API（如 Jira 或 GitHub）来完成任务。
• 描述是关键： description 的质量直接决定了 Skill 是否能被准确、可靠地触发。花时间写一个清晰、具体、涵盖所有触发场景的描述。
• 从简到繁： 从不包含脚本的简单 Skill 开始，先确保工作流在 SKILL.md 中定义清晰。当流程稳定后，再将可确定的、重复性的步骤固化为脚本。
• 安全第一： 只从你信任的来源安装 Skills。在安装第三方 Skill 之前，务必审查其包含的所有文件，特别是可执行脚本，以防范数据泄露或恶意操作的风险。

6. 结论

Claude Skills 是一个强大的范式转变，它将 AI 的能力从“即兴回答”提升到了“系统化执行”。通过将专业知识和流程封装为可复用的模块，开发者和团队可以构建出更可靠、更高效、更专业的 AI 助手，从而真正实现工作流程的自动化和智能化。掌握 Skills 的创建和使用，将是未来充分利用 AI 潜力的关键一步。

7. 关键信息来源

• 官方公告与介绍:
  • Introducing Agent Skills (Claude Blog)
  • Equipping agents for the real world with Agent Skills (Anthropic Engineering Blog)
• 官方代码与示例:
  • Public repository for Skills (GitHub)
• 官方帮助与文档:
  • What are Skills? (Claude Help Center)
  • Using Skills in Claude (Claude Help Center)