关于 skill-validator
用于检查 AI Agent Skills 是否符合 agentskills.io 标准及仓库的 AGENTS.md 规则，验证 YAML 和 Markdown 规范，不运行技能或检查其内部逻辑。
主要功能
- 01检查 agentskills.io 合规性
- 02应用仓库 AGENTS.md 规则
- 03验证技能的 YAML 和 Markdown
- 04标记缺失或无效的技能定义
- 05只读访问并在本地运行
适用场景
- 01开发时检查技能
- 02在 CI 中拦截不合规拉取请求
- 03审计 agent-skills/ 目录
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/skill-validator确认已加载。
附带文件skill.yaml
详细介绍
Skill Validator
目的与意图
skill-validator 是此仓库的主要质量控制工具。它通过根据 agentskills.io 标准和仓库的 AGENTS.md 规则进行验证，确保每个 AI Agent Skill 都可供机器使用。
何时使用
- 开发期间：每次创建或修改 Skill 时都运行此 Skill。
- CI/CD 集成：自动阻止包含不合规 Skill 定义的 Pull Request。
- 仓库审计：定期扫描整个
agent-skills/目录，确保随着规范演进，长期保持合规。
何时不使用
- 代码逻辑验证：此工具不会运行 Skill，也不会验证其内部逻辑；它只验证“契约”（YAML 和 Markdown）。
错误情况和边缘案例
- 无效 YAML：如果无法解析
skill.yaml，验证器会立即因语法错误而失败。 - 缺少必填字段：任何
agentskills.io规范中定义的字段缺失，都会导致is_valid: false。 - 空目录：
agent-skills/中不包含skill.yaml的文件夹会被标记为无效 Skill。
安全与数据处理注意事项
- 只读访问：此 Skill 只需要对目标目录具有读取权限。
- 不进行外部调用：验证使用内嵌的架构规则在本地执行。
评论
支持 Markdown