enoch-robinson Skill Creator
指导创建高质量的 Skills，扩展 Claude 的专业能力。
什么是 Skill？
Skill 是模块化、自包含的能力包，通过提供专业知识、工作流程和工具来扩展 Claude 的能力。它们就像特定领域的"入职指南"——将Claude 从通用助手转变为特定任务的专家。
Skill 能提供什么
- 专业工作流 - 特定领域的多步骤流程
- 工具集成 - 特定文件格式或API 的操作指南
- 领域知识 - 公司特定的知识、模式、业务逻辑
- 捆绑资源 - 脚本、参考文档、模板资源
核心原则
1. 简洁至上
上下文窗口是公共资源。Skill 与系统提示、对话历史、用户请求共享空间。
默认假设：Claude 已经很聪明。 只添加 Claude 不知道的内容。对每条信息提问：
- "Claude 真的需要这个解释吗？"
- "这段内容值得占用 token 吗？"
优先使用简洁示例，而非冗长解释。
2. 设置适当的自由度
根据任务的脆弱性和可变性匹配具体程度：
| 自由度 | 形式 | 适用场景 |
|---|---|---|
| 高 | 文本指令 | 多种方法有效、依赖上下文决策 |
| 中 | 伪代码/带参数脚本 | 存在首选模式、允许一定变化 |
| 低 | 具体脚本、少量参数 | 操作脆弱易错、一致性关键 |
3. 渐进式披露
Skill 使用三级加载系统管理上下文：
- 元数据 (name + description) - 始终在上下文中 (~100词)
- SKILL.md 正文 - 触发时加载 (<5k词)
- 捆绑资源 - 按需加载 (无限制)
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
- 编写 frontmatter（name + description）
- 编写核心指令和工作流
- 添加示例和指南
- 引用捆绑资源
步骤 5：测试验证
- 在实际场景中测试 Skill
- 验证触发条件是否准确
- 检查输出是否符合预期
步骤 6：迭代优化
根据使用反馈持续改进：
- 补充遗漏的场景
- 优化指令清晰度
- 精简冗余内容
最佳实践
Description编写要点
Description 是 Skill 的主要触发机制，必须包含：
- 功能描述：Skill 做什么
- 触发条件：何时使用这个 Skill
- 使用场景：具体的应用示例
#❌ 不好的 description
description: 处理 PDF 文件
# ✅ 好的 description
description: PDF 处理工具包，用于提取文本和表格、创建新PDF、合并拆分文档、处理表单。当需要程序化处理、生成或分析 PDF 文档时使用。
内容组织原则
- SKILL.md 保持精简 - 控制在 500 行以内
- 详细内容放references/ - 按需加载
- 避免重复 - 信息只在一处存在
- 清晰引用 - 明确说明何时读取哪个文件
检查清单
创建 Skill 前确认：
-
name使用小写和连字符 -
description包含功能和触发条件 - 指令简洁，无冗余解释
- 示例具体可操作
- 资源文件有清晰引用
- 在实际场景中测试过