用途
Skill Check 用于审计智能体技能(agent skills),检查其是否符合 agentskills.io 规范、是否遵循最佳实践,以及整体质量水平。当用户需要“审计技能”“校验技能”时可以使用该工具。
主要能力
- 结构校验:通过
scripts/validate-structure.sh path/to/target-skill快速校验技能结构。 - 规范核对:读取
references/spec-requirements.md,逐条对照规范规则检查 frontmatter。 - 最佳实践评估:读取
references/best-practices.md,逐条评估正文内容是否符合最佳实践指南。 - 评估门禁检查:检查
<skill-path>/evals/evals.json是否存在,记录 YES/NO。 - 结构对比:运行
scripts/compare-structure.sh <skill-path>,输出与 skills-ref 模式的结构差异。 - 报告生成:读取
assets/skill-check-report-template.html,填充模板变量生成 HTML 审计报告,并写入<skill-path>/<skill-name>-skill-check-report.html。
使用方式
工作流程如下:
- 读取目标
SKILL.md,提取 frontmatter YAML 和正文内容。 - 运行
scripts/validate-structure.sh <skill-path>,捕获通过/失败输出。 - 读取
references/spec-requirements.md,对照每条规范规则检查 frontmatter。 - 读取
references/best-practices.md,对照每条最佳实践指南评估正文。 - 检查评估门禁:
<skill-path>/evals/evals.json是否存在,记录 YES/NO。 - 运行
scripts/compare-structure.sh <skill-path>,输出与 skills-ref 模式的结构差异。 - 读取
assets/skill-check-report-template.html,用审计数据填充模板变量,包括技能名称、目标路径、审计日期、各项得分与百分比、分类、副标题、表格行、警告与修复项、等级、结论文本,以及 JSON 摘要。 - 将填充后的报告写入
<skill-path>/<skill-name>-skill-check-report.html。
JSON 摘要为紧凑 JSON 对象,包含所有得分、每项检查的通过/失败状态以及机器可解析结构,嵌入报告顶部的 <pre> 块中,便于下游技能仅读取前约 30 行即可获取机器数据。其 schema 包含:skill、target_path、audit_date、grade、spec(score、total、checks 数组)、best_practices(score、total、warnings 数组)、has_evals、structure(score、found、warnings)、fixes(priority、description)。
参考文件
spec-requirements.md:所有规范条款。best-practices.md:质量指南。skills-ref-patterns.md:结构模式。skill-check-report-template.html:模板化 HTML 报告(用于第 7 步)。
适用场景
适用于需要对智能体技能进行规范合规性审计、最佳实践遵循度评估和质量检查的场景,尤其适合在技能开发、发布前校验或持续质量保障流程中使用。
限制
资料中未提供关于收费、价格、平台支持范围、具体效果指标或额外使用步骤的说明,这些信息暂未提供。