前言

在深入这份官方指南之前，我想先和你分享一个有趣的背景：Anthropic团队发现，Claude的强大能力正在吸引越来越多非技术背景的用户——水管工开始打开终端，父母和祖父母在谷歌搜索"如何安装npm"。这意味着Skills的设计必须既专业又友好，让技术专家和普通用户都能受益。

官方指南详细阐述了如何创建、测试和优化Skills。我将逐段解读，并结合实际例子帮助你更好地理解。

一、先搞懂：Skill到底是什么？

简单说：Skill就是给Claude的"使用说明书"。

比如你想让Claude帮你处理PDF文件，每次都要说一堆话：

“帮我读这个PDF，提取里面的文字，然后整理成markdown格式，标题用##，列表用-…”

有了Skill之后，你只需要说：

“处理这个PDF”

Claude就会自动按照你写好的"说明书"来操作。

Skill的本质：把重复性的工作流程打包，让Claude一键执行。

---

二、写一个Skill需要准备什么？

就两样东西：

1. 一个文件夹（名字随便起，比如my-pdf-skill）
2. 一个文件（必须叫SKILL.md，注意大小写）

就这么简单！文件夹里放什么？后面会讲。

---

三、第一个Skill：手把手教学

我们来写一个超简单的Skill：让Claude帮你把文章转换成"小红书风格"。

第1步：创建文件夹和文件

# 创建一个文件夹
mkdir xiaohongshu-skill

# 进入文件夹
cd xiaohongshu-skill

# 创建SKILL.md文件（用记事本也行）
touch SKILL.md

第2步：写SKILL.md的内容

用记事本打开SKILL.md，复制下面的内容：

---
name: xiaohongshu-writer
description: 把普通文章转换成小红书风格。当用户说"写小红书"、"发小红书笔记"、"小红书风格"时使用。
---

# 小红书笔记生成器

你是一个小红书爆款笔记写作专家。请把用户输入的内容转换成小红书风格。

## 转换规则

1. 标题要吸引眼球，可以用：
   - 数字：3个秘诀、5个方法
   - 疑问句：你知道吗？你会吗？
   - 夸张词：绝了！必看！

2. 正文格式：
   - 多用emoji，每段开头加一个
   - 句子短，一行一句
   - 加话题标签 #好物分享 #经验分享

3. 语气：
   - 像朋友聊天，亲切自然
   - 多用"姐妹们"、"真的绝了"、"一定要试试"

## 例子

输入：
这个面霜很好用，保湿效果好，价格200块。

输出：
姐妹们！发现宝藏面霜了！✨

真的巨好用！上脸一秒化水 💦
保湿效果绝绝子，一整天都不干
关键是才200块，性价比无敌了！

#好物分享 #面霜推荐 #护肤日常

搞定！这就是一个完整的Skill。

第3步：怎么用这个Skill？

在Claude Code或Claude.ai中，只要你说的话触发了description里的关键词，比如：

“帮我把这段话写成小红书笔记：这个洗发水洗完很蓬松”

Claude就会自动调用这个Skill，按照你写的规则来生成内容。

---

四、Skill的核心结构：就三部分

任何一个Skill都由三部分组成，很简单：

1. 头部信息（必须写）

---
name: skill的名字       # 比如 xiaohongshu-writer
description: 什么时候用这个Skill   # 最重要！决定了Claude会不会调用它
---

description怎么写才有效？

❌ 错误写法：

description: 把文章转换成小红书风格

✅ 正确写法：

description: 把普通文章转换成小红书风格。当用户提到小红书、发笔记、写种草文、内容运营时都要用，即使没说"小红书"，只要是想发社交媒体的内容，都应该考虑使用这个技能。

秘诀：写得"夸张"一点，把可能相关的场景都列进去。因为Claude有时候会比较"懒"，不太爱调用Skill。

2. 主体内容（核心指令）

就是告诉Claude具体怎么做。用大白话写就行，就像教一个新同事：

# 标题说明这个Skill是干啥的

## 第一步做什么
1. 先看用户发了什么内容
2. 提取关键信息

## 第二步做什么
按照下面的规则转换...

## 注意事项
- 别忘了加emoji
- 标题要吸引人

3. 例子（非常重要！）

## 举个例子

用户说：这个洗面奶洗得很干净

你应该输出：
洁面神器！洗一次就爱上 🧴

泡沫超级绵密，像在云朵里洗脸
洗完不紧绷，干净不假滑
油皮姐妹闭眼入！

#洁面分享 #护肤 #油皮亲妈

为什么例子很重要？ Claude看到例子，就明白你想要的效果是什么样的。

---

五、Skill的"进阶玩法"：加资源文件

当你的Skill变复杂了，可以把内容分开存放：

my-skill/                # 主文件夹
├── SKILL.md             # 主说明书（必须）
├── scripts/             # 放代码（如果需要）
│   └── format.py
├── references/          # 放参考资料
│   └── style-guide.md
└── assets/              # 放模板、图片等
    └── template.docx

什么时候需要这些？

• scripts/: 需要写代码处理数据时（比如解析Excel）
• references/: 有长篇的规范文档时（比如品牌设计规范）
• assets/: 有固定的输出模板时（比如周报模板）

举个实际例子：如果你写一个"周报生成器"Skill

weekly-report/
├── SKILL.md              # 主说明：怎么生成周报
├── scripts/
│   └── parse_data.py     # 解析Excel数据的代码
├── references/
│   └── company-terms.md  # 公司专用术语表
└── assets/
    └── template.docx     # 周报模板文件

这样SKILL.md就不用写得很长，只需要说：“用parse_data.py处理数据，参考company-terms.md里的术语，套用template.docx生成周报”。

---

六、怎么测试你的Skill好不好用？

写完了Skill，怎么知道它好不好？官方推荐的方法是"测试-反馈-改进"循环。

第1步：写几个测试问题

想想用户实际会怎么问：

测试1："我要发小红书，这个面霜很好用"
测试2："帮我把这段话写成种草文：这个耳机音质好，续航长"
测试3："写个小文案：新出的奶茶很好喝"

第2步：让Claude跑一下

用Claude执行这些测试，看看输出效果。

第3步：根据结果改进

发现问题1：输出的内容太长了

• 改进：在SKILL.md里加一句"控制在100字以内"

发现问题2：忘了加话题标签

• 改进：在规则里强调"最后必须加3-5个话题标签"

发现问题3：语气不够"小红书"

• 改进：多给几个例子，让Claude学习

第4步：重复以上步骤

直到你对结果满意为止。

---

七、写Skill的4个实用技巧

技巧1：用"为什么"代替"必须"

❌ 别这么写：

必须使用感叹号！必须加emoji！必须短句！

✅ 可以这么写：

小红书用户喜欢有感染力的内容，多用感叹号和emoji能让文字更生动。短句更适合手机阅读，一目了然。

Claude理解了"为什么"，就知道该怎么灵活应用了。

技巧2：给例子比给规则有用

❌ 光给规则：

标题要用数字开头

✅ 规则+例子：

标题要用数字开头，比如：
- 3个让你变美的小习惯
- 5款无限回购的面膜
- 1分钟学会的眼妆技巧

技巧3：想清楚"什么时候用"

这是最关键的！写好description，Claude才知道什么时候该出手。

错误：

description: 写小红书文案

正确：

description: 把普通内容转换成小红书/抖音/微博等社交媒体风格的文案。当用户提到：发小红书、写种草文、做内容运营、写文案、社交媒体发布，或者用户发的内容像是要发社交媒体的（如产品体验、好物分享），都应该考虑使用这个技能。

技巧4：先简单，再复杂

第一次写Skill，不要想一口气做得很复杂。

新手友好路线：

1. 先写个最简单的（比如转换格式）
2. 测试运行，看看效果
3. 发现问题再加规则
4. 需要代码再加scripts
5. 需要模板再加assets

慢慢来，一次加一点。

---

八、三个新手最常见的Skill例子

例子1：会议纪要整理器

---
name: meeting-notes
description: 把会议录音转成文字整理成规范的会议纪要。当用户说"整理会议记录"、"写会议纪要"时使用。
---

# 会议纪要整理专家

把用户发的会议内容整理成标准格式。

## 输出格式

# [会议主题]

## 基本信息
- 时间：
- 参会人：
- 记录人：

## 会议内容
- 讨论要点：
- 决策事项：
- 待办任务：

## 例子

输入：
下午开会讨论了新app功能，决定先做登录功能，小王负责前端，小李负责后端，下周五前完成。

输出：
# App开发会议纪要

## 基本信息
- 时间：未提供（请补充）
- 参会人：小王、小李
- 记录人：Claude

## 会议内容
- 讨论要点：确定新app首期开发功能
- 决策事项：先开发登录功能
- 待办任务：
  - 小王：负责前端开发，下周五前完成
  - 小李：负责后端开发，下周五前完成

例子2：邮件润色助手

---
name: email-polish
description: 把草稿邮件改得更专业得体。当用户说"帮我写邮件"、"润色邮件"、"改一下这封邮件"时使用。
---

# 邮件润色专家

帮用户把草稿邮件改得更专业、更得体。

## 润色规则

1. 根据收件人调整语气：
   - 老板/客户：正式、尊敬
   - 同事：友好、直接
   - 下属：鼓励、明确

2. 常见问题修改：
   - 太长 → 精简
   - 太冲 → 委婉
   - 太模糊 → 具体

## 例子

输入：
老板，那个报告我还没写完，再给我两天

输出（正式版）：
王总您好，

关于上周布置的报告，我需要再多两天时间完善细节，预计本周五前可以完成。如果有急需的部分，我可以先整理出来给您。

感谢理解！

[姓名]

例子3：代码注释生成器

---
name: code-commenter
description: 给代码添加规范的注释。当用户说"加注释"、"写文档"、"解释这段代码"时使用。
---

# 代码注释专家

给代码添加清晰、有用的注释。

## 注释规则

1. 函数注释包含：
   - 功能说明
   - 参数说明
   - 返回值说明
   - 使用示例

2. 复杂逻辑加行内注释
3. 注释要说明"为什么"，不只是"是什么"

## 例子

输入：
def calc(a,b):
    return a*b*0.8

输出：
def calc(a, b):
    """
    计算商品折扣价
    
    参数：
        a: float - 原价
        b: float - 折扣率（如0.8表示8折）
    
    返回：
        float - 折后价
    
    示例：
        >>> calc(100, 0.8)
        80.0
    """
    # 原价 × 折扣率 = 折后价
    return a * b * 0.8

---

九、常见问题解答

Q1：Skill写好了，怎么给Claude用？

Claude Code用户：

# 把Skill放到指定目录
cp -r my-skill ~/.claude/skills/

Claude.ai用户：

• 在设置里找到"Skills"选项
• 点击"添加Skill"
• 选择你的.skill文件（需要先打包）

Q2：怎么打包Skill？

python -m scripts.package_skill my-skill/

会生成一个my-skill.skill文件，这就是可以分享、安装的文件。

Q3：Skill写得太长了怎么办？

把内容拆分：

• 主SKILL.md保持在500行以内
• 长的内容放到references/里
• 在SKILL.md里说"详见references/xxx.md"

Q4：怎么知道我的Skill有没有被调用？

Claude会告诉你：

“我正在使用xiaohongshu-writer技能来帮你…”

如果没有提示，可能description写得不够好，Claude没识别出来需要调用它。

Q5：可以写恶意Skill吗？

绝对不行！ 官方明确禁止：

• 恶意软件
• 盗取数据
• 未经授权的访问
• 欺骗性内容

只能写正经有用的Skill。

---

十、总结：写Skill的"三步法"

看完这么多，其实写Skill就三步：

第一步：想清楚

• 这个Skill帮用户做什么？
• 用户什么时候会用到？
• 输出应该长什么样？

第二步：写下来

---
name: 起个名
description: 什么时候用它
---

# 标题

怎么做，一步步写清楚

## 例子
输入：xxx
输出：xxx

第三步：测试改进

• 写2-3个测试问题
• 看看Claude做得怎么样
• 哪里不好就改哪里
• 重复直到满意

---

如何写好 Skills（建议）

1、功能拆小，只做一件事

每个 Skill 保持简单专一，就像一块小积木，只解决一个明确问题，方便后续组合和复用。

2、用示例代替长篇说明

不用费劲解释，直接给几组清晰的输入输出例子，模型就能立刻明白你要的风格、格式和结果。

3、给清晰规则，不乱发挥

先定好角色，再把任务拆成步骤，同时明确哪些不能做，避免模型跑偏或编造内容。

4、固定输入输出，像接口一样稳定

提前规定好输入参数和输出格式（如 JSON、Markdown），让 Skill 能被稳定调用、方便集成。

5、不断优化，越用越准

把使用中出现的问题整理成新规则或反例，持续迭代，让 Skill 越来越可靠。

写在最后

写Skill没有想象中那么难。你就把它想象成给一个新同事写"工作指南"——用最直白的话，告诉他遇到什么情况该怎么做，最好给几个例子参考。

先从简单的开始，比如"帮我整理会议纪要"、“帮我润色邮件”，熟练了再尝试复杂的。

如果写的过程中遇到问题，随时可以问我。祝你写出第一个属于自己的Skill！