手把手教你给Claude装\"技能\"：Claude官方Skills创建指南

技能到底是什么？

一句话总结：技能就是一个教Claude干活的"说明书文件夹"。

它不是什么高深的代码项目。本质上就是一个文件夹，里面放着几个文件，告诉Claude："遇到这类任务，按这个流程来。"

这个文件夹的结构很简单：

• SKILL.md（必须有）：核心说明书，告诉Claude这个技能干什么、什么时候用、具体怎么做
• scripts/（可选）：放一些辅助脚本，比如Python脚本来处理数据
• references/（可选）：参考文档，需要时Claude会自己去翻
• assets/（可选）：模板、图标等素材

就这么简单。你不需要会编程，会写Markdown就行。

技能的三大类型

Anthropic观察到大家用技能主要做三件事：

第一类：生成内容

比如写��档、做PPT、设计前端页面。你把风格指南、模板结构、质量标准写进技能里，Claude每次生成的东西就能保持一致。

举个例子：你经常需要写项目周报，格式都差不多。做个"周报技能"，以后只要说"帮我写本周周报"，Claude就知道用什么格式、什么语气、包含哪些模块。

第二类：自动化流程

多步骤的工作流程，从头到尾自动执行。比如"新客户上线流程"：创建账号→设置支付→创建订阅→发欢迎邮件，一条龙搞定。

第三类：增强MCP连接器

这个稍微技术一点。MCP是Anthropic做的一个协议，让Claude能连接外部工具（比如Notion、Linear、Slack）。技能就是在这个基础上，教Claude怎么把这些工具用好。

打个比方：MCP给了Claude一个专业厨房（工具齐全），技能就是菜谱（教它怎么做菜）。光有厨房不够，得有菜谱才能做出好菜。

SKILL.md怎么写？看这里

SKILL.md是整个技能的核心。它分两部分：

第一部分：YAML头部（门面信息）

这部分决定了Claude什么时候会调用你的技能。只需要两个字段：

---
name: weekly-report
description: 生成团队周报。当用户说"写周报"、"本周总结"、"weekly report"时使用。
---

name用英文，小写加横杠连接（叫kebab-case），比如my-cool-skill。

description是关键中的关键——它必须同时说清楚两件事：

1. 这个技能做什么
2. 什么时候该用它（触发条件）

写得好的例子：

"管理Linear项目流程，包括冲刺规划、任务创建和状态跟踪。当用户提到'冲刺'、'创建任务'、'项目规划'时使用。"

写得烂的例子：

"帮助处理项目。"（太模糊了，Claude根本不知道什么时候该用它）

第二部分：正文说明

头部之后就是具体的操作指令，用Markdown写。官方推荐的结构：

1. 步骤说明：把流程分步骤写清楚，每一步做什么、用什么工具
2. 示例：给几个具体的使用场景，比如"用户说xxx时，执行abc步骤"
3. 错误处理：常见问题怎么解决

写指令的关键原则：

• 要具体：别写"验证数据"，要写"运行python scripts/validate.py来检查格式"
• 要有错误处理：告诉Claude如果某一步失败了怎么办
• 重要的事放前面：Claude优先看开头的内容
• 用列表和序号：比大段文字更容易被Claude理解

"三层披露"设计——省Token的秘诀

Anthropic设计了一个聪明的机制，叫"渐进式披露"（Progressive Disclosure）：

第一层：YAML头部 → 永远加载在Claude的系统提示里（很短，不费Token） 第二层：SKILL.md正文 → Claude觉得相关时才加载 第三层：references里的文件 → Claude需要时才去翻

这意味着你可以放心往references里塞详细的参考文档，不用担心浪费Token。SKILL.md本身尽量精简（官方建议不超过5000词），详细内容都丢到references里。

从零开始做一个技能：实操指南

好了，理论讲完了，下面是实操步骤：

步骤一：想清楚你要解决什么问题

先列出2-3个具体的使用场景。比如你想做一个"公众号写作技能"：

• 场景1：给一个话题，生成完整的公众号文章
• 场景2：给一篇英文文章，改写成中文公众号风格
• 场景3：给一个产品，写一篇测评文章

步骤二：创建文件夹

wechat-writer/
├── SKILL.md
├── references/
│   └── style-guide.md
└── assets/
    └── article-template.md

文件夹名必须用小写英文+横杠，不能有空格、大写字母或下划线。

步骤三：写 SKILL.md

---
name: wechat-writer
description: 撰写微信公众号文章。当用户说"写公众号文章"、"写一篇文章"、
"帮我写推文"时使用。支持从话题、英文文章、产品信息等多种输入生成文章。
---

# 微信公众号写作技能

## 使用方法
用户提供话题、URL或文本内容，按以下流程生成文章。

## 步骤1：分析输入
- 如果是URL：抓取文章内容
- 如果是话题：确认写作角度
- 如果是文本：提取核心信息

## 步骤2：撰写文章
按以下规范：
- 标题：15-30字，有冲击力
- 正文：1500-3000字
- 语气：口语化，像朋友聊天
- 结构：引言→正文（每300-500字一个小标题）→总结→互动

## 步骤3：优化检查
- 开头是否抓人？（禁止"随着XX的发展"开头）
- 是否有具体数据和案例？
- 结尾是否有行动建议和互动引导？

步骤四：安装到Claude

Claude.ai网页版： 设置 → 功能 → 技能 → 上传（把文件夹压缩成zip上传）

Claude Code命令行版： 直接把文件夹放到Claude Code的技能目录里

步骤五：测试

装好之后，试着对Claude说几句话，看它会不会自动调用你的技能：

• "帮我写一篇关于AI的公众号文章" ← 应该触发
• "今天天气怎么样" ← 不应该触发
• "写一篇测评" ← 应该触发

如果不触发，回去改description，加更多触发词。如果太容易触发（不相关的话题也会用），就把description写得更具体。

有个调试小技巧：直接问Claude "你什么时候会用wechat-writer技能？"，它会把description念给你听，你就知道哪里需要改了。

五个进阶模式

官方总结了五种常见的技能设计模式，适合不同场景：

常见问题排查

上传失败，提示"找不到SKILL.md" → 文件名必须是大写的SKILL.md，不能是skill.md或Skill.md

技能装了但不触发 → description写得太模糊。加具体的触发短语，比如"当用户说xxx时使用"

技能触发太频繁（不该用的时候也用了） → 在description里加排除条件："不要用于xxx场景"

Claude不按技能里的指令做 → 指令太长太啰嗦。精简SKILL.md，把详细内容移到references/里。关键指令放最前面，用加粗或"重要"标题标出来

说实话，技能这个功能的设计思路很聪明——它把"教AI"这件事变成了一个可复用、可分享的标准化流程。你教一次，以后每次对话都能用。你还能把自己做的技能分享给同事或者社区。

Anthropic说用skill-creator（官方内置的技能制作助手），15-30分钟就能做出第一个能用的技能。

如果你经常用Claude做重复性的工作，强烈建议花半小时试试。

Anthropic 官方的 Claude Skill 完全构建指南：

The-Complete-Guide-to-Building-Skill-for-Claude.pdf

The-Complete-Guide-to-Building-Skill-for-Claude_dual_OpenAI.pdf

The-Complete-Guide-to-Building-Skill-for-Claude_translated_OpenAI.pdf