SuperAPI AI 工具集

validate-skills

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

validate-skills 用于校验 skills/ 目录下的所有技能是否符合 agentskills.io 规范与 Claude Code 最佳实践。其校验清单包含两方面。规范合规:name 为 1-64 字符、仅小写字母数字与连字符,且不含首尾或连续连字符;目录名必须与 name 字段一致;description 长度 1-1024 字符且非空;license、metadata、compatibility 等可选字段若存在则需有效。最佳实践:description 使用第三人称并说明“做什么+何时使用”;正文长度低于 500 行;加载层级为一层深,即 SKILL.md 是唯一渐进式披露入口,每个引用文件都必须可从 SKILL.md 直接到达;引用之间可交叉链接用于导航,但仅能通过另一引用间接到达的文件视为缺陷;链接须用 markdown 的 text,不能只写裸文件名;正文不重复 description;内容精炼,只补充 Claude 尚不具备的上下文。运行方式:用 fd -t d -d 1 . skills/ 找出所有技能目录,逐个读取 SKILL.md 并按上述规则检查,结果按“### 路径”“- [PASS]/[FAIL] 说明”格式报告。限制:具体校验粒度与自动修复能力暂未提供,且规则以 agentskills.io 规范和 Claude Code 最佳实践为准,未列出其他平台支持。