用途:在合并任何新增或修改的技能前,校验 SKILL.md 是否符合 agentskills.io 开放标准,也适用于批量审计某领域技能、验证 create-skill 生成的技能,以及评审贡献者在拉取请求中提交的技能。
主要能力:检查文件是否存在并统计行数;校验 YAML frontmatter 的必需字段(name、description、license、allowed-tools)与推荐的 metadata 字段(author、version、domain、complexity、language、tags);对翻译文件做额外校验,包括 locale 等五个翻译字段、正文语言是否为目标语言、代码块是否与英文源一致;检查六个必需章节;检查每个 Procedure 步骤是否含 Expected 与 On failure 块;确认行数不超过 500 行;核对 skills/_registry.yml 中的 id、path、complexity、description 及 total_skills 计数。
使用方式:输入为 SKILL.md 路径(必填),可选 strictness(lenient 或 strict,默认 strict)与是否检查注册表同步(默认是)。典型命令包括 test -f skills/<skill-name>/SKILL.md、wc -l、grep 检查 frontmatter 与章节、以及 grep 核对注册表条目。
限制:需按 agentskills.io 标准使用。正则检查可能漏掉 YAML 多行写法;Validation 章节可写作 Validation Checklist;lenient 模式仍会标记缺失章节与字段,仅放宽风格与元数据建议;翻译技能易出现正文仍为英文而通过结构检查的情况。