用途:按 Agent Skills 规范(agentskills.io)标准化与校验 SKILL.md 文件。适用于从零创建 SKILL.md、审计既有技能是否符合规范、把旧格式(非标准标题、frontmatter)转换为标准格式、改进描述以更可靠触发、为技能添加评测用例(evals/evals.json),以及批量校验目录内所有技能。
主要能力:校验必填 frontmatter 字段(name、description)、name 格式(小写、无连续连字符、与父目录名一致)、description 长度(1–1024 字符)、allowed-tools 是否为空格分隔、推荐章节是否存在、文件是否超过 500 行。规范字段还包括可选的 allowed-tools、compatibility(最多 500 字符)、license、metadata。标准目录结构含 SKILL.md(必需)及可选的 scripts/、references/、assets/、evals/evals.json。渐进披露分三层:目录层(name+description,约 100 tokens)、指令层(完整正文,<5000 tokens、最多 500 行)、资源层(按需加载)。
使用方式:校验单个技能目录运行 bash scripts/validate_skill.sh path/to/skill-directory;批量校验运行 bash scripts/validate_skill.sh --all .agent-skills/。创建新技能可用模板,frontmatter 中 name 与 description 必填,description 建议用祈使句、描述用户意图、列出触发关键词并控制在 1024 字符内。旧标题可映射为标准标题,如 Purpose/When to Use 改为 When to use this skill,Procedure 改为 Instructions,Best Practices 改为 Best practices,Reference 改为 References,Output Format 改为 Output format。评测用例写入 evals/evals.json,含 2–5 个真实提示与可验证断言。
限制与注意:脚本应避免交互式提示,使用 --flag 输入;建议固定脚本版本(如 uvx ruff@0.8.0);脚本输出优先结构化(JSON/CSV),数据到 stdout、诊断到 stderr;发布前建议至少添加 2–3 个评测用例。资料未提供具体收费、价格、平台支持范围与效果数据。