Skill Creator

指导创建高质量的 Skills，扩展 Claude 的专业能力。

什么是 Skill？

Skill 是模块化、自包含的能力包，通过提供专业知识、工作流程和工具来扩展 Claude 的能力。它们就像特定领域的"入职指南"——将Claude 从通用助手转变为特定任务的专家。

Skill 能提供什么

1. 专业工作流 - 特定领域的多步骤流程
2. 工具集成 - 特定文件格式或API 的操作指南
3. 领域知识 - 公司特定的知识、模式、业务逻辑
4. 捆绑资源 - 脚本、参考文档、模板资源

核心原则

1. 简洁至上

上下文窗口是公共资源。Skill 与系统提示、对话历史、用户请求共享空间。

默认假设：Claude 已经很聪明。 只添加 Claude 不知道的内容。对每条信息提问：

• "Claude 真的需要这个解释吗？"
• "这段内容值得占用 token 吗？"

优先使用简洁示例，而非冗长解释。

2. 设置适当的自由度

根据任务的脆弱性和可变性匹配具体程度：

自由度	形式	适用场景
高	文本指令	多种方法有效、依赖上下文决策
中	伪代码/带参数脚本	存在首选模式、允许一定变化
低	具体脚本、少量参数	操作脆弱易错、一致性关键

3. 渐进式披露

Skill 使用三级加载系统管理上下文：

1. 元数据 (name + description) - 始终在上下文中 (~100词)
2. SKILL.md 正文 - 触发时加载 (<5k词)
3. 捆绑资源 - 按需加载 (无限制)

Skill 结构

每个 Skill 由必需的 SKILL.md 文件和可选的捆绑资源组成：

skill-name/
├── SKILL.md (必需)
│   ├── YAML frontmatter (必需)
│   │   ├── name: (必需)
│   │   └── description: (必需)
│   └── Markdown 指令 (必需)
└── 捆绑资源 (可选)
    ├── scripts/      - 可执行脚本 (Python/Bash等)
    ├── references/   - 按需加载的参考文档
    └── assets/       - 输出中使用的文件 (模板、图标等)

SKILL.md 组成

Frontmatter (YAML)

---
name: my-skill-name
description: 清晰描述功能和使用场景。这是触发机制的关键。
---

• name: 唯一标识符（小写，用连字符分隔）
• description: 完整描述功能和触发条件

Body (Markdown)

Skill 的具体指令、示例和指南。仅在Skill 触发后加载。

##创建流程

步骤 1：理解需求

通过具体示例理解 Skill 的使用场景：

• "这个 Skill 应该支持什么功能？"
• "用户会如何使用它？"
• "什么情况下应该触发这个 Skill？"

步骤 2：规划资源

分析每个示例，确定需要的可复用资源：

• scripts/ - 重复编写的代码 →脚本化
• references/ - 需要参考的文档 → 文档化
• assets/ - 输出中使用的文件 → 模板化

步骤 3：创建目录结构

mkdir -p my-skill/{scripts,references,assets}
touch my-skill/SKILL.md

步骤 4：编写 SKILL.md

1. 编写 frontmatter（name + description）
2. 编写核心指令和工作流
3. 添加示例和指南
4. 引用捆绑资源

步骤 5：测试验证

• 在实际场景中测试 Skill
• 验证触发条件是否准确
• 检查输出是否符合预期

步骤 6：迭代优化

根据使用反馈持续改进：

• 补充遗漏的场景
• 优化指令清晰度
• 精简冗余内容

最佳实践

Description编写要点

Description 是 Skill 的主要触发机制，必须包含：

• 功能描述：Skill 做什么
• 触发条件：何时使用这个 Skill
• 使用场景：具体的应用示例

#❌ 不好的 description
description: 处理 PDF 文件

# ✅ 好的 description
description: PDF 处理工具包，用于提取文本和表格、创建新PDF、合并拆分文档、处理表单。当需要程序化处理、生成或分析 PDF 文档时使用。

内容组织原则

1. SKILL.md 保持精简 - 控制在 500 行以内
2. 详细内容放references/ - 按需加载
3. 避免重复 - 信息只在一处存在
4. 清晰引用 - 明确说明何时读取哪个文件

检查清单

创建 Skill 前确认：

• name 使用小写和连字符
• description 包含功能和触发条件
• 指令简洁，无冗余解释
• 示例具体可操作
• 资源文件有清晰引用
• 在实际场景中测试过