Skill Creator 是一个用于创建有效技能的指南技能,当用户想要创建新技能(或更新已有技能)以扩展 Claude 能力时使用。
一、用途与定位 技能是模块化、自包含的软件包,通过提供专门的知识、工作流和工具来扩展 Claude 的能力。可以把它们理解为面向特定领域或任务的“入门指南”,将 Claude 从通用型代理转变为配备程序性知识的专用代理。技能可提供:专门工作流(针对特定领域的多步骤流程)、工具集成(处理特定文件格式或 API 的说明)、领域专业知识(公司特定知识、schema、业务逻辑)以及打包资源(用于复杂重复任务的脚本、参考文档和素材)。
二、核心原则
- 简洁优先:上下文窗口是公共资源,技能与其他内容共享上下文窗口。默认假设 Claude 已经非常聪明,只补充 Claude 原本不具备的上下文,对每条信息都追问“Claude 真的需要这个解释吗”“这段内容是否值得其 token 成本”,优先使用简洁示例而非冗长说明。
- 设定适当自由度:依据任务的脆弱性和可变性匹配具体程度。高自由度(基于文本的指令)适用于多种方法皆可、依赖上下文判断、由启发式引导的场景;中自由度(伪代码或带参数的脚本)适用于存在首选模式、允许一定变化、配置影响行为的场景;低自由度(特定脚本、少量参数)适用于操作脆弱易错、一致性要求高、必须遵循特定顺序的场景。
三、技能结构 每个技能包含必需的 SKILL.md 文件与可选的打包资源: skill-name/ ├── SKILL.md(必需) │ ├── YAML frontmatter 元数据(必需):name(必需)、description(必需) │ └── Markdown 指令(必需) └── 打包资源(可选) ├── scripts/ - 可执行代码(Python/Bash 等) ├── references/ - 按需加载进上下文的文档 └── assets/ - 用于输出结果的文件(模板、图标、字体等)
SKILL.md 中,frontmatter 只包含 name 与 description,这两个字段是 Claude 判断技能何时被使用的唯一依据;正文(Markdown)仅在技能触发后加载。正文应保持简洁,控制在 500 行以内。
打包资源说明:
- scripts/:用于需要确定性可靠性或反复重写的任务,例如 scripts/rotate_pdf.py 用于 PDF 旋转。优点是 token 高效、结果确定、可不加载进上下文直接执行;但 Claude 仍可能需要读取脚本以进行修补或环境适配。
- references/:按需加载进上下文以指导 Claude 处理的文档,例如财务 schema、公司 NDA 模板、公司政策、API 规格。适用于数据库 schema、API 文档、领域知识、公司政策、详细工作流指南。最佳实践:若文件超过 1 万词,在 SKILL.md 中提供 grep 搜索模式;避免信息在 SKILL.md 与 references 中重复,详细资料优先放在 references。
- assets/:不加载进上下文、而在 Claude 产出结果中使用的文件,例如品牌 logo、PowerPoint 模板、HTML/React 样板、字体。适用于模板、图片、图标、样板代码、字体、被复制或修改的示例文档。
技能不应包含无关文档或辅助文件,例如 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等;技能只应包含 AI 代理完成任务所需的信息。
四、渐进式披露 技能采用三级加载系统:元数据(name + description)始终在上下文中(约 100 词);SKILL.md 正文在技能触发时加载(少于 5k 词);打包资源由 Claude 按需使用。拆出内容时须在 SKILL.md 中引用并清楚说明何时读取。常见模式:高层指南加引用(如 PDF 处理在 SKILL.md 中给出快速上手并指向 FORMS.md、REFERENCE.md、EXAMPLES.md);按领域组织(如 bigquery-skill 按 finance、sales、product、marketing 拆分参考文件);条件式细节(如 DOCX 处理按简单编辑、修订追踪、OOXML 细节分别指向不同文件)。指南要求引用保持距 SKILL.md 一层深度,超过 100 行的参考文件在顶部加目录。
五、创建流程
- 用具体示例理解技能:明确技能将如何被使用,可来自用户示例或经用户反馈验证的生成示例,例如构建图像编辑技能时询问应支持哪些功能、使用示例、触发语句。
- 规划可复用技能内容:分析每个示例从零执行的步骤,识别可重复使用的脚本、参考和素材,例如 PDF 旋转需要 scripts/rotate_pdf.py,前端应用需要 assets/ 样板,BigQuery 需要 references/schema.md。
- 初始化技能:运行 scripts/init_skill.py <skill-name> --path <output-directory>,生成包含正确 frontmatter 和 TODO 占位符的 SKILL.md 模板以及 scripts/、references/、assets/ 示例目录。
- 编辑技能:为另一个 Claude 实例编写信息,先实现可复用资源并实际运行脚本测试,删除不需要的示例文件和目录,随后更新 SKILL.md(始终使用祈使/不定式,frontmatter 只写 name 和 description,description 需说明技能做什么以及何时使用,不在正文写“何时使用”)。可参考 references/workflows.md(多步骤流程与条件逻辑)和 references/output-patterns.md(模板与示例模式)。
- 打包技能:运行 scripts/package_skill.py <path/to/skill-folder>,可指定输出目录如 ./dist;打包脚本会自动校验 YAML frontmatter 格式与必填字段、技能命名约定与目录结构、description 等。
- 基于真实使用迭代。
以上步骤应按顺序执行,仅在明确不适用时跳过。
六、限制与说明 资料未提供该技能的收费、价格、平台支持等具体信息,暂未提供。