用途:Skill Builder 用于按官方规范与最佳实践创建可投产的 Agent Skills,覆盖从明确目标到验证测试的完整流程。当用户提到“build a skill”“create a skill”“generate a skill”“design a skill”“new skill”等关键词时自动激活。
主要能力:分五步创建技能——Clarify(明确用途、范围、激活关键词)、Design(规划结构、决定渐进式披露)、Generate(生成带正确 frontmatter 的 SKILL.md)、Validate(对照规范与最佳实践检查)、Test(验证激活与行为)。同时提供验证清单与支持文件(reference.md 详细模式、examples.md 工作流与示例)。
规范要点:frontmatter 仅两个必填字段——name(小写、连字符、1-64 字符、与目录名一致)与 description(1-1024 字符、第三人称、包含触发关键词、说明做什么与何时使用)。可选字段有 license、compatibility、metadata、allowed-tools;Claude Code 额外支持 disable-model-invocation、user-invocable、model、context、agent、hooks、argument-hint。不应使用 version、auto_activates、priority_score、source_urls、evaluation_criteria、invokes、philosophy、maturity 等任何运行时都不识别的字段;版本应放在 metadata.version。
最佳实践:保持简洁,只补充模型不具备的上下文,正文控制在 500 行以内;采用渐进式披露,启动仅加载名称与描述,激活时加载 SKILL.md,支持文件按需加载且引用不超过一层;区分高、中、低自由度;避免时间敏感表述(如“as of today”“new in v3.0”),需要时用 old patterns 段落保留历史背景;用验证器循环修正错误。
使用方式:先阅读权威资料,再按五步流程产出,并确保通过验证清单(frontmatter 有效、命名合规、描述达标、正文长度、引用层级、无过时内容、术语一致、至少用 3 个代表性提示测试)。
限制:官方文档为最终依据,若本技能内容与文档冲突以官方为准。其余关于平台支持范围、收费与具体运行时行为的信息暂未提供。