用途:skill-validator 是该仓库的主要质量控制工具,用于确保每个 AI Agent Skill 符合 agentskills.io 标准与仓库 AGENTS.md 规则,从而具备“机器可消费”性。
主要能力:校验技能的“契约”部分,即 YAML 与 Markdown 定义,而非运行技能或验证其内部逻辑。可检查 YAML 是否可解析、agentskills.io 规范要求的必填字段是否缺失,以及 agent-skills/ 下不含 skill.yaml 的空目录。
使用方式:在开发过程中,每次创建或修改技能后运行该技能;可集成到 CI/CD,自动阻止包含不合规技能定义的 Pull Request;也可定期扫描整个 agent-skills/ 目录,以在规范演进时保持长期合规。
限制与边界:不执行技能,也不验证代码逻辑。若 skill.yaml 无法解析,会立即以语法错误失败;任何缺失的必填字段会导致 is_valid: false;不含 skill.yaml 的目录会被标记为无效技能。安全方面仅需目标目录的只读权限,校验在本地使用内嵌 schema 规则完成,不进行外部调用。
适用场景:技能开发、CI/CD 合规拦截、仓库定期审计。具体安装命令、运行命令、输出格式与价格信息暂未提供。