技能规范校验器
检查 Agent Skill 是否符合规范与 Claude Code 最佳实践。
技能主要进行文件读取和静态检查,未要求凭据、敏感数据或破坏性操作,因此基础权限风险较低;但未说明数据流、用户确认、隔离、回滚或依赖安全,且来源归因仅有作者字段和 MIT 许可,发布者身份未验证,故扣分。
检查清单、步骤和报告格式较明确,但依赖未声明的 fd 命令,未提供脚本、测试、异常输入处理或失败诊断;同时目标路径为 .claude/skills/validate-skills,而正文针对 skills/,存在路径适配不一致。静态证据不足,按上限保守评分。
受众和调用方式(/validate-skills)明确,适用于技能规范与文档检查;但未定义输入输出边界、非适用场景、触发条件细节或中文支持,也未说明环境依赖和网络可达性,故仅给有限分数。
结构清晰,包含元数据、检查表、操作步骤、示例输出和 Markdown 链接规范,并声明 MIT;但缺少版本号、变更记录、维护责任、更新路径、依赖说明和故障排查,且引用的外部规范未在本地固定版本。
清单可指导人工完成核心验证,并给出可直接复用的报告格式;但没有实现验证器、提交测试或代表性结果,且步骤仍需人工逐个读取文件,实际输出完整性和相对手工检查的增益证据有限。
技能内容本身可审计,规则和示例报告便于复核;但没有第三方执行证据、自动化测试或覆盖关键路径的 CI,无法静态确认其实际发现问题的准确性,因此仅给有限分数。
- 正文针对 skills/,但评估路径位于 .claude/skills/validate-skills;使用前应确认目标目录和仓库结构。
- 技能依赖 fd 命令且未提供替代方案、错误处理或自动化测试,异常环境下可能需要人工排查。
- 外部规范链接未固定版本,且未说明对中文提示或中国大陆网络环境的适配。
这个 Skill 能做什么,适合哪些场景?
这是一个用于校验 Agent Skills 的开发工具技能,目标是检查技能是否符合 agentskills.io 规范和 Claude Code 最佳实践。它会逐个审查技能目录中的 SKILL.md,并验证名称、描述、可选字段、正文长度、引用加载层级及 Markdown 链接等内容。执行结果按技能目录输出 PASS/FAIL 报告。该技能位于仓库的 .claude/skills/validate-skills/SKILL.md,正文默认面向 skills/ 目录。
查找 skills/ 下的技能目录;读取每个技能的 SKILL.md;检查名称格式及其与目录名的一致性、描述长度、可选字段、描述写法、正文行数、引用文件是否可由 SKILL.md 直接发现、链接格式、重复内容和简洁性;最后生成包含各项 PASS/FAIL 结果的验证报告。
- 技能作者提交新 SKILL.md 前,需要检查名称、描述和结构是否符合 agentskills.io 规范。
- 维护者审查仓库内多个技能,想统一检查 Claude Code 最佳实践时。
- 团队修改引用文件后,需要确认渐进式加载没有形成隐藏的多层引用链时。
- 希望在发布技能集合前获得按目录划分的具体问题清单时。
这个 Skill 有哪些优点和局限?
- 检查项具体,覆盖规范合规性、描述质量、正文长度和引用结构。
- 输出格式明确,便于逐个技能定位问题。
- 采用 MIT 许可证,并注明作者为 Callstack。
- 正文将目标目录写为 skills/,与该技能实际位于 .claude/skills/ 的路径存在范围上的不一致。
- 源材料没有提供测试结果、测试套件或已验证的平台清单。
- 使用 `/validate-skills` 这一 Claude Code 命令,迁移到其他客户端需要调整触发方式。
- 源材料没有说明失败后的自动修复能力;其描述仅支持验证和报告。
如何安装这个 Skill?
源材料没有提供该技能的专用安装命令。它随 callstackincubator/agent-skills 仓库提供,文件路径为 .claude/skills/validate-skills/SKILL.md。README 记录了整个集合的 Claude Code、Codex 及其他助手安装方式,但没有单独列出 validate-skills 的安装步骤。
如何使用这个 Skill?
在支持该技能的 Claude Code 环境中使用 /validate-skills 命令。技能说明要求检查 skills/ 目录下的所有技能,并建议使用 fd -t d -d 1 . skills/ 查找技能目录;报告格式为按目录列出的 ## Validation Results、检查项及 [PASS]/[FAIL] 结果。