skill-creator

Skill Creator - Claude 技能创建完整指南

技能概述

Skill Creator 是一个完整的技能开发指南，帮助您为 Claude 创建高效、可重用的技能包，将通用 AI 转变为具备领域专业知识、定制化工作流和工具集成的专业代理。

适用场景

创建新的扩展技能

当您希望 Claude 掌握特定领域的专业知识或执行定制化工作流时，使用本指南从零开始设计和开发技能包。

更新和完善现有技能

当已有技能需要优化架构、增加新功能或修复问题时，参考本指南的迭代流程进行改进。

企业知识封装与共享

当企业需要将内部知识、业务流程、API 集成封装为可重用的技能资产，并在团队间分发和管理时使用。

核心功能

完整的技能创建流程

提供从理解需求、规划资源、初始化模板、编写内容到打包分发的六步开发流程，每步都有明确的工具和验证方法，确保技能符合最佳实践。

渐进式披露设计原则

指导您设计三层加载系统（元数据 → SKILL.md → 资源文件），让 Claude 在需要时才加载详细内容，既保证功能完整性又优化上下文管理。

可重用资源组织规范

明确 scripts/（可执行代码）、references/（文档引用）、assets/（输出资源）的使用场景和最佳实践，帮助您合理组织技能的可重用组件，提升开发效率和复用性。

常见问题

如何从零开始创建一个 Claude 技能？

首先明确技能的具体使用场景和功能需求，然后使用 scripts/init_skill.py <skill-name> 生成标准模板，接着根据规划填充 scripts/、references/、assets/ 目录，最后编写 SKILL.md 并使用 scripts/package_skill.py 验证打包。完整的六步流程详见技能文档。

SKILL.md 文件必须包含哪些内容？

SKILL.md 必须包含 YAML frontmatter 元数据（name 和 description 字段）以及 Markdown 正文。元数据决定了技能何时被触发，正文应包含技能用途、适用场景和资源使用说明。description 应使用第三人称客观描述，清晰说明"这个技能应该在什么情况下使用"。

技能的 scripts/、references/、assets/ 目录有什么区别？

这三个目录分别存储不同类型的可重用资源：scripts/ 存放可执行代码（如 Python 脚本），用于需要确定性可靠性的任务；references/ 存放文档和参考资料（如 API 文档、数据结构），供 Claude 按需加载到上下文；assets/ 存放输出中使用的文件（如模板、图标、字体），不会被加载到上下文而是直接复制使用。

什么是渐进式披露设计原则？

渐进式披露是技能的上下文管理策略，将信息分为三个层级：元数据（name + description）始终加载约 100 词；SKILL.md 正文技能触发时加载约 5000 词；打包资源按需加载无限量。这样既保证 Claude 能正确使用技能，又避免不必要的上下文消耗。

如何验证和打包技能以便分发？

使用 scripts/package_skill.py <skill-folder> 命令，脚本会自动验证技能的格式、结构和描述质量，验证通过后生成同名 zip 分发包。如果验证失败会报告具体错误，修复后重新打包即可。支持指定输出目录：scripts/package_skill.py <skill-folder> ./dist。

技能应该包含哪些可重用资源？

根据技能的具体需求选择：如果相同代码反复重写，放入 scripts/；如果需要查阅的文档或知识库，放入 references/；如果输出需要模板或素材，放入 assets/。原则是避免重复劳动和上下文膨胀，将确定性的、可复用的内容模块化。

如何设计适合自己业务的技能架构？

分析核心业务场景中哪些知识、流程和工具是重复使用的，将这些抽象为技能组件。优先考虑 scripts/ 存储业务逻辑脚本，references/ 存储领域知识文档，assets/ 存储业务模板。使用渐进式披露原则设计信息层级，确保 Claude 在需要时能找到正确的指导。

技能创建完成后如何迭代和改进？

在实际使用中观察技能的表现，记录遇到的问题和效率瓶颈。根据反馈更新 SKILL.md 的指导说明，调整 scripts/、references/、assets/ 的内容组织，然后重新打包验证。迭代过程中保持技能的核心用途不变，聚焦于提升可用性和效率。