用途:本技能提供在仓库中创建或更新技能的说明,涵盖必需结构、frontmatter 与最佳实践,适用于编写新技能或修订技能结构。
主要能力:每个技能是一个目录,内含带 YAML frontmatter 和 Markdown 正文的 SKILL.md。frontmatter 必需字段:name 为 kebab-case 标识符(仅小写字母、数字、连字符,如 add-feature-flag、pdf-processing、update-skill);description 需非空,说明技能做什么及何时使用,包含便于发现的关键词,以动作动词开头并用第三人称,如“Adds feature flags... Use when working with feature flags”。
结构:典型章节包括标题与简要概述、概述(可选)、主体内容(步骤、用法或工作流)、最佳实践(可选)、示例/参考 PR(可选)。简单技能可省略可选章节。
文件组织:简单技能(不超过约 200 行)全部放在 SKILL.md;复杂技能(超过 200 行)将详细内容拆分到 references/ 子目录,并在 SKILL.md 中用清晰链接引用,如“See references/best-practices.md for detailed guidance”。当 SKILL.md 接近 200 行以上、技能覆盖多个可独立加载的领域或工作流、或详细参考材料会干扰主说明时,应拆分内容。SKILL.md 只保留必要的工作流与过程说明。
验证:可选使用 skills-ref 参考库验证技能,命令为:
skills-ref validate ./my-skill
该命令检查 SKILL.md frontmatter 是否有效并符合命名约定。若未安装,资料建议使用 WebSearch 工具获取该包的上下文。
限制:资料未提供该技能的收费、价格、平台或效果信息;具体最佳实践细节需查阅 references/best-practices.md,本资料未展开其内容。