用途：SkillCheck 用于校验 SKILL.md 文件是否符合 agentskills 规范与 Anthropic 最佳实践，在一次只读检查中捕获结构性错误、语义矛盾、命名反模式和内容质量缺口。适合发布到市场前审查技能、排查技能无法正确触发的原因，或在团队内推行技能编写规范时使用。官方说明其不用于反低质检测、安全扫描或 token 分析，这些需使用 SkillCheck Pro。
主要能力：按顺序执行 Free 层级检查，覆盖结构（1.x，如名称格式、描述 WHAT+WHEN、allowed-tools、分类、XML 注入，捕获格式错误与缺失字段）、正文（2.x，行数、硬编码路径、过期日期、空章节、弃用语法、MCP 工具限定）、命名（3.x，模糊词、单词名、动名词建议）、语义（4.x，矛盾、歧义词、缺失输出格式、泛泛的至理名言、触发条件错位）以及质量（8.x，示例、错误处理、触发条件、输出格式、前置条件、负面触发）。随后计算总分（0-100），扣分规则为 critical 扣 20、warning 扣 5、suggestion 扣 1，最后返回结构化结果：分数、等级（Excellent/Good/Needs Work/Poor）、含检查 ID 与行号的 issue 列表、消息及修复建议。
使用方式：当用户说“check skill”“skillcheck”或“validate SKILL.md”时触发。示例：用户输入“check my skill at ~/.claude/skills/weekly-report/SKILL.md”，输出为分数 85/100（Good）及警告与建议；输入“skillcheck ~/.claude/skills/processing-pdfs/SKILL.md”，输出 100/100（Excellent），31 项检查全部通过。
限制：仅只读，不会修改文件；Free 层级只覆盖结构、语义与命名检查，反低质、安全、WCAG、token、企业和工作流检查需 SkillCheck Pro；语义检查（矛盾检测、至理名言）为启发式，约 5% 误报率；不校验被引用的文件或脚本，只检查 SKILL.md 内容；仅单文件校验，不与其他技能交叉比对。
最佳实践与常见问题：提交市场前先运行；修复所有 critical 与 warning，建议项可选；用检查 ID（如 1.2-desc-when）在技能正文中定位规则；修复后重跑确认分数提升。分数偏低多因建议项，其总分上限为扣 15 分，应优先处理警告与严重项；代码块内的歧义词可能误报，SkillCheck 会跳过代码块与行内代码，仍误报可用反引号包裹；至理名言检查可能误判合理指令，应将泛泛建议改为具体指令（如“提交前运行测试”）。