skill-creator

• "帮我创建一个 skill"
• "把这个变成 skill"
• "新建技能"
• "/create-skill"

---

Skill 是模块化的能力包，用于扩展 Claude 的能力：

• 专业工作流：多步骤的领域流程
• 工具集成：特定文件格式或 API 的使用方法
• 领域知识：公司特定知识、schema、业务逻辑
• 打包资源：脚本、参考文档、资产文件

---

```

skill-name/

├── SKILL.md # 必须 - 核心指令

└── 可选资源/

├── scripts/ # 可执行脚本（Python/Bash）

├── references/ # 参考文档（按需加载）

└── assets/ # 输出资源（模板、图标）

```

---

```yaml

---

name: skill-name

description: 做什么 + 什么时候触发（这是最重要的字段）

---

# Skill 标题

[指令内容]

• "关键词1"
• "关键词2"

1. xxx
2. xxx

[示例用法]

```

---

1. 简洁为王

• 上下文窗口是共享的，假设 Claude 已经很聪明
• 只添加 Claude 不知道的信息
• 用简洁示例代替冗长解释

2. 设置合适的自由度

| 自由度 | 何时使用 | 形式 |

|--------|---------|------|

| 高 | 多种有效方法，依赖上下文判断 | 文字说明 |

| 中 | 有推荐模式，允许一些变化 | 伪代码/脚本 |

| 低 | 操作脆弱，一致性关键 | 精确脚本 |

3. 渐进加载（三层）

1. 元数据（~100词）- 始终在上下文中
2. SKILL.md 主体（<5k词）- skill 触发时加载
3. 附加资源 - Claude 按需加载

---

Step 1: 理解需求

• 这个 skill 要做什么？
• 用户会怎么触发它？
• 需要什么输入/输出？

Step 2: 规划资源

• 需要脚本吗？放 scripts/
• 需要参考文档吗？放 references/
• 需要模板/资产吗？放 assets/

Step 3: 创建目录

```bash

mkdir -p .claude/skills/你的skill名

```

Step 4: 编写 SKILL.md

• frontmatter: 清晰的 name + 全面的 description
• body: 使用 skill 和资源的指令

Step 5: 测试迭代

1. 在真实任务中使用
2. 发现问题或低效
3. 更新 SKILL.md 或资源
4. 重复

---

• README.md
• INSTALLATION_GUIDE.md
• CHANGELOG.md
• 其他与 skill 功能无关的文件

---

| 位置 | 作用域 |

|------|--------|

| ~/.claude/skills/ | 个人全局 |

| 项目/.claude/skills/ | 项目级，可 git 共享 |

---

用户：帮我把"渲染公众号文章"变成 skill

执行：

1. 创建目录 .claude/skills/render-article/
2. 编写 SKILL.md
3. 测试触发词是否有效

---

参考：[官方 Skill 仓库](https://github.com/anthropics/skills)