弄懂SKILLS是什么？怎么创建？如何使用 --知识铺

hello，我是CY-CHENYUE

今天，想和大家一起聊下Skills

这个可以

教导 Claude 按照标准作业程序（SOP）完成特定领域的专业任务的技能。

简单的说，

它能让一个“通用的聊天机器人”转变为一个“具备特定领域专业能力的数字员工”

这篇，想从下面三点，

Skills底层逻辑（知道是怎么工作的）

怎么创建Skills（怎么用）

怎么来用Skills（实际应用）

这样就可以快速的上手用上Skills

Claude Agent Skills 底层逻辑流程图

1. 感知阶段 (Level 1: Metadata - 系统启动)

◦ 动作：系统将所有已安装技能的名称、描述（Frontmatter）加载到系统提示词的 Skill 工具中。

◦ 原理：每项技能仅占约 100 Tokens，确保模型在不浪费上下文的情况下，感知自己拥有的专家能力。

2. 触发阶段 (Discovery & Reasoning - 用户输入)

◦ 动作：Claude 接收用户指令（如“分析这份 PDF”），扫描技能清单。

◦ 原理：纯语义路由。系统不使用硬编码或算法分发，而是依靠 LLM 的推理能力，自主判断当前任务与哪项技能的描述最匹配，随后调用 Skill 元工具。

3. 激活阶段 (Level 2: Activation - 秘密注入)

◦ 动作：系统通过 Bash 命令读取该技能目录下的 SKILL.md 指令正文。

◦ 原理：上下文与环境注入。系统注入一条隐藏消息（isMeta: true），让 Claude 获得该领域的 SOP。同时，动态修改执行权限（Allowed Tools）或切换至更强大的模型（如 Claude Opus）。

4. 执行阶段 (Level 3: Execution - 程序化编排)

◦ 动作：Claude 根据 SOP 编写 Python 脚本并在沙盒 VM 中运行，或读取关联的参考文件。

◦ 原理：程序化工具调用 (PTC)。复杂逻辑由代码在本地处理，生成的 MB 级中间数据不进入对话上下文，模型只接收精炼的结果摘要。这种方式可减少约 37% 的 Token 消耗并极大降低幻觉率

Claude Skills（智能体技能） 如何作为 AI Agent 的 标准作业程序 (SOP) 来提升任务执行的可靠性。

• Agent 的“入职指南”：就像企业通过 SOP 减少人为误差一样，Claude Skills 通过文件夹形式打包指令（SKILL.md）、脚本和资源，为 Agent 提供执行特定任务的标准化流程。

• 按需加载与 Token 优化：技能采用“渐进式披露”机制，仅在任务相关时才将详细指令载入上下文，这能有效防止上下文污染并节省 Token 消耗。

• Skill Creator 工具：它可以引导用户通过对话设计工作流，并自动生成符合规范的技能文件夹和 SKILL.md 文件。

• 从工具调用到程序化编排：相较于传统的 MCP（模型上下文协议）侧重于数据接入，Skills 更侧重于“提示词层”的逻辑控制，通过绑定 Python 脚本，让 Agent 的行为更具确定性。

MCP和Skills的区别是什么？

简单说，

MCP将Claude与数据连接起来。

Skills教会Claude如何使用这些数据。

怎么用

最简单的方法，打开claude

启用功能：在“设置 (Settings)” > “能力 (Capabilities)”中确保已开启 Skills 选项。

创建skills的方法有三种

对比三种方式

Create with Claude不确定怎么写，让 AI 引导你

Write skill instructions已经想好内容，直接填表单

Upload a skill已有 .zip 或 .skill 文件，直接导入

第一种

Create with Claude

直接与claude对话创建

这个最简单

你想做什么，直接说，剩下的交给AI

聊完之后，技能可以直接下载或者添加到skills里面

比如，点击"copy to your skills"，技能就添加成功了

第二种

Write skill instructions

适合你已经知道要写什么内容，直接手写技能指令。

点击后会进入一个编辑界面，让你填写：

需要填写的内容

1. Name（技能名称）

2. 例如：contrast-storytelling

3. Description（描述）

4. 例如：对比叙事法写作技能，用于公众号/自媒体文章创作...

5. Instructions（指令正文）

6. 就是 SKILL.md 里 --- 下面的内容

7. 核心理念、写作流程、模板、示例等

第二种方式本质上就是一个可视化表单，帮你生成 SKILL.md 文件，不需要自己手动创建文件夹和写 YAML frontmatter

第三种

Upload a skill

如果我们有一些skills是别人的，或者说自己创建的，想分享。

就可以用这个方式

文件要求

• .zip 或 .skill 文件，需在根目录包含 SKILL.md 文件

• SKILL.md 文件需包含以 YAML 格式编写的技能名称和描述

skill 文件本质上也是一个 zip 压缩包，只是后缀名不同。

你可以把 .zip 改名为 .skill

文件夹的结构：

contrast-storytelling/

├── SKILL.md

├── reference.md      ← 可选

└── scripts/          ← 可选

└── helper.py

通过这些方法，就可以快速上手创建自己的Skills

创建好了怎么用？

自动触发

正常聊天就行，技能会自动生效。

手动调用

Claude.ai 网页版 :

使用 contrast-storytelling 技能帮我写一篇文章

Claude Code：

/contrast-storytelling

写好 description 是关键，

它决定了 Claude 什么时候触发技能。

这里需要了解一下SKILL.md的文档结构

SKILL.md 文件是智能体技能的核心，

采用YAML 前置配置（Frontmatter）与Markdown指令****正文构成的两部分结构。

以下是其标准文件结构：

1. YAML 前置配置 (Metadata)

位于文件顶部，由 --- 分隔，用于配置技能的运行方式和触发逻辑。

• name (必填)：技能的唯一标识符，仅限小写字母、数字和连字符，最大 64 字符。

• description (必填)：详细描述技能功能及触发场景。Claude 依靠此描述进行语义匹配来决定何时激活技能。

• allowed-tools (可选)：声明技能激活时无需额外授权即可使用的工具列表（如 Read, Write, Bash）。

• model (可选)：指定运行该技能时的特定模型（如 claude-3-5-sonnet-latest）。

2. Markdown指令正文 (Instructions)

紧随前置配置之后，定义 Claude 的具体行为、工作流和输出标准。建议结构包括：

• 项目概述：简述技能目的。

• 具体步骤：使用祈使句（如“分析代码…”）描述标准作业程序 (SOP)。

• 参考资源：利用 {baseDir} 变量引用文件夹内的脚本或辅助文档。

• 输出示例：提供具体的输入/输出示例以对齐模型预期。

编写提示：建议将 SKILL.md 保持在 500 行以内以优化上下文效率，更复杂的内容应拆分到独立参考文件中。

今天就聊到这里，

后续有时间和大家聊聊在code claude里面的使用