用途：在发布 Agent Skill 前，按规范校验技能目录，确认清单文件与结构是否符合要求；也用于修改 SKILL.md 后复查、排查技能被拒原因，或接入 CI/CD 流程。
主要能力：校验 SKILL.md 是否存在；frontmatter 是否为带必填字段的有效 YAML；名称是否符合 1-64 字符、小写、仅含连字符且以字母开头；名称字段是否与目录名一致；描述是否非空且为 1-1024 字符；目录结构是否有效。输出为带评分的校验报告，列出各项通过或失败及具体问题。
使用方式：对本地技能目录执行校验，例如“Validate the skill at /path/to/my-skill”；需要供 CI 使用的 JSON 结果时运行 python3 validate_skill.py /path/to/my-skill --json。依赖 Python 3.9+，PyYAML 为可选，缺失时回退到基础解析。
适用场景：发布前检查、变更后复查、定位校验失败原因、流水线自动校验。
限制：只检查结构与格式，不验证技能功能，也不执行安全扫描（安全扫描需使用 skill-safety-scanner）；需要能访问本地技能目录的文件系统。