写完 Skill 不放心？让 Claude 帮你自己审一遍——SkillCheck Free 上手

拾遗·Skill精选官 内容创作者 2026-09-14 1553 阅读

最近我在挑 Skill 的时候，脑子里反复冒出一个问题：GitHub 上关于 Claude Code 的 Skill 已经突破 2.4 万个，可真正能装上不翻车的，连 10% 都不到——要么 YAML frontmatter 写崩了，要么 description 没动词、触发不出来，要么引用了根本不存在的工具名。这两天翻到一个专门「验 Skill 的 Skill」，叫 SkillCheck Free，顿时感觉捡到宝了。

它到底干啥的

SkillCheck Free 本质上是一个 SKILL.md 静态校验器，对标的是 agentskills.io 那个开放标准。它把 Skill 文件按 30 多条规则逐条扫一遍，分四个等级（Critical / Warning / Suggestion / Passed）告诉你哪里要改：

  • 结构层（1.x）：name 格式合不合法、description 有没有用「动词+触发场景」、tools 字段是否过时、有没有 XML 注入风险；
  • 触发层（2.x）：skill 描述里有没有写清楚「用户说 X 时才触发」，避免它乱抢活；
  • 语义层（3.x）：歧义词（「若干」「一些」）会被标出来，让你写得精确；
  • 集成层（4.x）：plugin manifest / MCP tool 列表是否符合 Claude Code 规范。

最贴心的是输出示例——skillcheck my skill 一行命令，直接给你列「Critical: 1 | Warnings: 2 | Suggestions: 3 | Passed: 44」，每条都带行号和修复建议，debug 体验堪比 ESLint。

为什么对 Skill 创作者来说是刚需

做 Skill 评测这半年，我踩过最深的坑就是「自己写的时候觉得 OK，扔 Claude Code 里才发现它死活不触发」。事后查原因，80% 都是 description 没写明白「WHEN 触发」——只写了「WHAT 能做什么」。SkillCheck 的 1.2 规则会直接告诉你「缺动词」，并把业界共识的「Create/Generate/Build/Convert」开头的模板递到你嘴边。等于你写一个 Skill，它先用「编辑器视角」帮你预审一遍，再上架。

另一个我特别喜欢的细节：它跨平台——同一个 skill-check 文件夹同时支持 Claude Code（~/.claude/skills/）、Claude Desktop/Web（Project 自定义指令）、Cursor（.cursor/rules/）。一次校验，三端都能跑，对同时用多个 AI IDE 的朋友是真省事。

怎么用

一行 clone + cp 就能上手：

git clone https://github.com/olgasafonova/SkillCheck-Free.git
cp -r SkillCheck-Free/skill-check ~/.claude/skills/

然后在 Claude Code 里随便说一句「skillcheck my skill」「validate 一下 path/to/SKILL.md」，它就开扫。开源、MIT 协议，37 stars、5 天前还在更新——属于小而精的那种，作者 Olga Safonova 对 agentskills 规范的跟进非常紧。

适用人群

  • 正在攒自己 Skill 集、想上架 marketplace 的开发者；
  • 团队里要 review 别人写的 Skill、又不想每次都人工通读的 Tech Lead；
  • 跟我一样的 Skill 评测人——写完一篇推荐稿，顺手跑一遍校验，免得推出去的 Skill 上线就报错。

把校验环节前置，省下来的 debug 时间比你想的多得多。

项目地址

GitHub: https://github.com/olgasafonova/SkillCheck-Free

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 1553 阅读