技能创建器

本技能提供创建有效技能的指导。

关于技能

技能是模块化、自包含的包，通过提供专业知识、工作流和工具来扩展 Claude 的能力。可以将它们视为特定领域或任务的"入职指南"——它们将 Claude 从通用代理转变为配备了模型本身无法完全具备的程序性知识的专业代理。

技能提供什么

1. 专业工作流 - 特定领域的多步骤流程
2. 工具集成 - 处理特定文件格式或 API 的指令
3. 领域专业知识 - 公司特定知识、Schema、业务逻辑
4. 捆绑资源 - 用于复杂和重复任务的脚本、参考资料和素材

技能的结构

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

skill-name/
├── SKILL.md（必需）
│   ├── YAML 前置元数据（必需）
│   │   ├── name:（必需）
│   │   └── description:（必需）
│   └── Markdown 指令（必需）
└── 捆绑资源（可选）
    ├── scripts/          - 可执行代码（Python/Bash 等）
    ├── references/       - 需要时加载到上下文中的文档
    └── assets/           - 用于输出的文件（模板、图标、字体等）

SKILL.md（必需）

元数据质量： YAML 前置数据中的 name 和 description 决定了 Claude 何时使用该技能。请具体说明技能的功能和使用时机。使用第三人称（例如"本技能应在...时使用"而非"在...时使用本技能"）。

捆绑资源（可选）

脚本（scripts/）

用于需要确定性可靠性或反复重写的任务的可执行代码（Python/Bash 等）。

• 何时包含：当相同代码被反复重写或需要确定性可靠性时
• 示例：scripts/rotate_pdf.py 用于 PDF 旋转任务
• 优势：节省 Token、确定性强、可在不加载到上下文的情况下执行
• 注意：脚本可能仍需要 Claude 读取以进行修补或环境特定调整

参考资料（references/）

需要时加载到上下文中以指导 Claude 流程和思考的文档和参考材料。

• 何时包含：Claude 在工作时应参考的文档
• 示例：references/finance.md 用于财务 Schema，references/mnda.md 用于公司保密协议模板，references/policies.md 用于公司政策，references/api_docs.md 用于 API 规范
• 用例：数据库 Schema、API 文档、领域知识、公司政策、详细工作流指南
• 优势：保持 SKILL.md 精简，仅在 Claude 确定需要时加载
• 最佳实践：如果文件较大（>10k 词），在 SKILL.md 中包含 grep 搜索模式
• 避免重复：信息应存在于 SKILL.md 或参考文件中，而非两者都有。除非信息确实是技能的核心，否则优先将详细信息放在参考文件中——这样可以保持 SKILL.md 精简，同时使信息可发现而不占用上下文窗口。仅在 SKILL.md 中保留核心程序性指令和工作流指导；将详细参考材料、Schema 和示例移至参考文件。

素材（assets/）

不打算加载到上下文中，而是在 Claude 产出中使用的文件。

• 何时包含：当技能需要在最终输出中使用的文件时
• 示例：assets/logo.png 用于品牌素材，assets/slides.pptx 用于 PowerPoint 模板，assets/frontend-template/ 用于 HTML/React 样板，assets/font.ttf 用于字体
• 用例：模板、图像、图标、样板代码、字体、被复制或修改的示例文档
• 优势：将输出资源与文档分离，使 Claude 能在不加载到上下文的情况下使用文件

渐进式披露设计原则

技能使用三级加载系统来高效管理上下文：

1. 元数据（名称 + 描述） - 始终在上下文中（约 100 词）
2. SKILL.md 正文 - 技能触发时加载（<5k 词）
3. 捆绑资源 - Claude 按需加载（无限制*）

*无限制是因为脚本可以在不读入上下文窗口的情况下执行。

技能创建流程

要创建技能，请按顺序遵循"技能创建流程"，仅在有明确理由说明不适用时才跳过步骤。

步骤 1：通过具体示例理解技能

仅当技能的使用模式已被清楚理解时才跳过此步骤。即使在处理现有技能时，此步骤仍然有价值。

要创建有效的技能，需要清楚理解技能将如何使用的具体示例。这种理解可以来自用户直接提供的示例或经过用户反馈验证的生成示例。