HereIsYourAi 把 Claude Skills 最有用的资源整理成一份结构化指南，分四个模块：

  • Module 1: Foundations（本文）
  • Module 2: Architecture
  • Module 3: Testing & Iteration
  • Module 4: Production Deployment

每个模块建立在前一个之上。如果认真过一遍，10 分钟内可以构建并部署你的第一个 Skill。

核心定义

Claude Skill 是一个持久化指令层，告诉 Claude 如何精确执行一个特定任务——一步一步来。

不需要在每次对话里重复指令，定义一次，永久复用。

三层体系的正确理解

Build anything 之前，先搞清 Skills 在整个生态里处于什么位置：

Projects → 你的知识库：存信息。传 PDF、指南、参考资料，告诉 Claude「这些是你需要知道的」。静态，信息类，只读。

Skills → 你的执行引擎：定义任务如何被执行。告诉 Claude「这就是你执行这个任务的方式」。程序性，可重复，可自动化。

MCP（Model Context Protocol）→ 连接层：把 Claude 连接到真实数据源——日历、数据库、邮件。Skills 再决定如何处理这些数据。

三次规则

如果你同一段指令输入超过三次，或者你想要一致、可重复的输出 → 你应该构建一个 Skill。

Skill 的物理结构

Skill 就是一个文件夹加一个指令文件：

your-skill-name/ ├── SKILL.md └── references/ （可选）

规则 1：文件夹命名用 kebab-case

全小写，单词之间用连字符分隔。

✅ 正确：email-formatter、invoice-generator、csv-cleaner ❌ 错误：带空格、下划线或大写

规则 2：SKILL.md 是核心

文件名必须精确是 SKILL.md，不能有任何变化。

规则 3：references/ 可选

用来放大型模板、品牌指南、长文档。不要让主文件变乱。

写 Skill 前的三个关键问题

大多数 Skill 在这个阶段就失败了——因为定义太模糊。清晰度决定后续表现。

问题 1：这个 Skill 做什么？

要极度具体。

❌ 弱：「帮我处理数据」 ✅ 强：「将凌乱的 CSV 文件转换为结构化表格，包含干净的表头、标准化的日期格式（YYYY-MM-DD），且无空行」

问题 2：何时激活？

从真实用户输入的角度思考：

  • 「Clean this CSV」
  • 「Fix this spreadsheet」
  • 「Format this dataset」

这些就是你的触发器。

问题 3：成功是什么样的？

不要描述，要展示。提供一个清晰的「之前 vs 之后」示例。

YAML Frontmatter 的作用

在 SKILL.md 顶部用 YAML block 定义 metadata，这个部分控制 Skill 何时激活。

三条核心规则：

  1. 用第三人称语言 ❌ 「I help users...」 ✅ 「Processes input data...」

  2. 触发器要明确 Claude 不会假设意图，必须清晰定义。

  3. 设置负面边界 定义 Skill 不应该在何时激活。这防止误触发。

最关键的字段是 description：

  • 太模糊 → Skill 永远不会激活
  • 太宽泛 → 错误激活

精确度决定一切。

工作流结构指南

  • 用直白的英语
  • 一步一步序列化的指令
  • 用标题组织

示例工作流（csv-cleaner）：

  1. 读取输入文件
  2. 识别结构和表头
  3. 移除空行或无效行
  4. 标准化数据格式
  5. 输出清洗后的版本和摘要

示例的力量

一个具体的示例比一堆抽象指令有效得多。始终包含：

  • 输入
  • 期望输出

references/ 的重要规则

references 最多只嵌套一层。不要把 reference 文件链接到其他 reference 文件。Claude 可能会截断上下文，错过重要信息。

部署

准备完毕后：

  1. 组织文件夹结构
  2. 把文件夹放进：~/.claude/skills/

完成。Claude 会自动检测并使用你的 Skill。

懒人方式：用 skill-creator

如果不想手动搭建：

  1. 开始一个新对话
  2. 说「为 [你的任务] 构建一个 Skill」
  3. 上传示例、模板或指南
  4. 回答几个结构化问题
  5. 让系统生成一切

系统会输出完整的 SKILL.md、正确的结构和可直接部署的配置。

读完本文，你已经理解：

  • Claude Skills 是什么
  • 它们处于什么位置
  • 它们如何结构化
  • 如何构建并部署你的第一个 Skill