开发与工程

SkillCheck Free

一个只读的 Linter 技能,让 AI 助手按 agentskills 规范检查你的 SKILL.md,在用户发现问题之前抓住结构、语义和安全隐患。

64/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code · Claude.ai
Star 数
★ 41
最近更新
14 天前
License
MIT
skill-validationlintingagentskills-specyaml-frontmatter
+4prompt-injection-detectionstatic-analysiscursor-rulesoffline

这个 Skill 能做什么,适合哪些场景?

SkillCheck Free 是一个可直接安装的技能/规则文件,安装后你的 AI 助手就能对目标 SKILL.md 执行结构、命名、语义和安全校验。它完全离线运行:只读取文件(Read/Glob/Grep),不调用外部 API,也不需要任何密钥。校验覆盖 YAML frontmatter 规范、描述触发词质量、矛盾与含糊措辞、知识密度,以及隐写 Unicode(ASCII 走私、双向控制符、零宽字符)等提示注入风险。输出一份带检查 ID、严重级别、行号和修复建议的报告,并把发现的良好实践单列为 strengths。Pro 版提供反 slop 检测、安全扫描、Eval Kit 等深度功能,本仓库仅含免费层规则。

  • 用 Glob 定位目标 SKILL.md(支持普通路径与命名空间路径),并加载同目录的 references/*.md
  • 校验 frontmatter:name/description 格式、agentskills 规范字段、Claude Code 与社区扩展字段、category 与 produces/consumes 格式
  • 语义检查:矛盾指令、含糊措辞、空洞的智慧/套话、路由内容错位、有约束无安全豁免等
  • 安全检查:frontmatter 中的 XML 尖括号、Unicode tag 字符走私(自动解码隐藏内容)、Trojan Source 双向控制符、零宽字符
  • 输出按技能分份的报告,每条问题含检查 ID、Critical/Warning/Suggestion 级别、行号与修复方法;良好实践单独列为 strengths
适合
  • 技能作者在发布 SKILL.md 前,让 Claude Code 做一次离线规范校验,拿到逐条修复建议
  • 维护多个团队技能库的工程师,对一个技能目录批量跑一遍检查,每人一份报告
  • 担心供应链安全的审阅者,用 Cat 30 隐写检查发现藏在不可见 Unicode 字符里的指令
  • 使用 Cursor 的开发者,把 cursor-rules/skill-check.mdc 复制到 .cursor/rules 后在项目内校验技能规则
  • 使用 Claude Projects 的用户,把校验规则粘贴进自定义指令,直接在 claude.ai 上检查技能定义
不适合
  • 需要反 slop 检测、安全扫描、token 预算分析、WCAG 合规或 Eval Kit 的团队——这些明确属于付费的 SkillCheck Pro,免费层不包含
  • 想用于 LinkedIn 技能互动分析的人——技能描述明确指向另一个 skillcheck-engage 技能
  • CI/CD 流水线用户——独立 CI/CD 二进制是 Pro 功能,免费层只能靠 AI 助手交互式运行

如何安装这个 Skill?

使用前请注意
  • 静态审查未执行任何检查,实际校验行为与误报率需使用者自行验证;4.6/4.9 等启发式检查存在作者自述的约5%误报率。
  • references/cli.md 指向独立仓库 skillcheck-cli,与本技能的关系及维护状态未说明,请勿混淆为同一工具。
  • 无 CHANGELOG,版本 3.32.0 无历史可追溯;发布者身份未经注册库验证。
  • 技能仅支持英文说明与输出,中文技能的语义检查适用性未声明。
开始前你需要
Agent 需要具备
  • 本地文件系统

最简单的方式是通过技能 CLI 安装:

Claude Code

npx skills add olgasafonova/SkillCheck-Free

或手动复制技能文件夹:

Claude Code

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

无需安装文件,把 frontmatter 之后的内容粘贴进 Project 自定义指令即可:

Claude.ai (Projects)

# 打开 claude.ai → Project 设置 → Custom instructions
# 粘贴 skills/skill-check/SKILL.md 中 --- 之后的内容

复制规则文件到项目规则目录:

Cursor

git clone https://github.com/olgasafonova/SkillCheck-Free.git
mkdir -p .cursor/rules
cp SkillCheck-Free/cursor-rules/skill-check.mdc .cursor/rules/

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • skillcheck my skill at ~/.claude/skills/weekly-reports/SKILL.md
  • check skill at path/to/SKILL.md and show me all Critical and Warning issues
  • validate my skills in ~/.claude/skills/ — one report per skill
  • skillcheck this skill folder and list its strengths as well

安装后在 Claude Code、Claude Desktop/Web 或 Cursor 中直接说 "skillcheck my skill" 或 "validate my skills"。技能按四步流程运行:Step 1 用 Glob 定位目标 SKILL.md;Step 2 读取技能正文和 references/ 文件;Step 3 按规则逐条校验;Step 4 输出报告。每个技能只跑一遍校验(最多 1 次迭代),检查是只读且幂等的,可安全重复运行;无法读取的 SKILL.md 会在报告中注明并中止。输入可以是指向单个 SKILL.md 的路径,也可以是一个技能目录(每技能一份报告)。

这个 Skill 有哪些优点和局限?

优点
  • 完全离线、只读运行:无需 API 密钥、环境变量或网络,适合安全敏感环境
  • 规则细致且可解释:每条发现都带检查 ID、严重级别、行号和具体修复建议
  • 覆盖面独特:包含隐写 Unicode / Trojan Source 检查这类多数 linter 没有的提示注入防线
  • 跨宿主可用:同一套规则适配 Claude Code、Claude Desktop/Web (Projects) 和 Cursor
  • 幂等且可重复运行,报告对未变更文件保持一致
局限
  • 深度能力被刻意留给 Pro 版:反 slop、安全扫描、token 分析、Eval Kit、CI/CD 二进制均不在免费层
  • 结果由 AI 助手按规则文件执行产生,不是确定性二进制,不同模型/会话的执行一致性依赖模型遵循能力
  • 仓库说明未提供独立测试套件或跨平台验证的证据;安装统计依赖 skills.sh 等第三方注册表
  • 资源很轻但需要理解校验报告的作者;对完全不了解 agentskills 规范的新手,建议先读规范本身

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
SkillCheck Free 本页 64 · 推荐 ★ 41 14 天前 MIT
技能规范校验器 45 · 不推荐 ★ 1.7k 17 天前 MIT
Claude Code 插件技能开发指南 ✓ Anthropic · 官方 51 · 谨慎使用 ★ 38k 11 天前 Apache-2.0
Claude Code 技能开发指南 ✓ Anthropic · 官方 46 · 谨慎使用 ★ 151k 11 天前 —
Claude 技能模板示例 ✓ Anthropic · 官方 58 · 推荐 ★ 38k 11 天前 Apache-2.0

这是 SkillCheck Pro 的免费层版本(getskillcheck.com):Pro 增加反 slop 检测、安全扫描、token 预算分析、WCAG、企业/生产就绪检查、Eval Kit 与 CI/CD 二进制。免费层保留结构、语义、命名、知识密度(空洞内容检测)、OWASP Agentic Top 10 的 8 项确定性检查以及全部隐写 Unicode 检查。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
64/ 100 五分制 3.2 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全20 / 25 · 4.0/5

该技能声明为只读(allowed-tools: Read Glob Grep),无网络访问、无环境变量、无副作用,工作流含执行上限与幂等声明,数据流向清晰。扣分点:发布者身份未经注册库验证,归因仅依赖自述作者字段,无外部回滚/确认机制说明(对只读检查不必要,但安全审计类检查的误报处理仅靠启发式声明)。未发现红线风险。

2可靠稳定12 / 20 · 3.0/5

SKILL.md 自身一致:四步工作流、执行上限、错误处理表、失败反馈(无法读取时在报告中说明)、已知误报披露(4.6 约5%误报)。扣分点:静态审查未执行,无已提交的测试套件覆盖关键检查路径,正则规则(如 Unicode 范围、BiDi 豁免)的正确性无法验证,依赖模型执行启发式检查本身引入不确定性。

3适用触发12 / 15 · 4.0/5

触发词明确(check skill、skillcheck、validate SKILL.md),负面触发(排除 Pro/LinkedIn 场景)清晰,输入输出契约明确,完全离线运行对中国大陆网络无依赖问题。扣分点:仅英文,无中文支持声明;对非 Claude Code 环境的部分行为(Claude Code 扩展字段)边界有说明但适用度有限。

4规范维护11 / 15 · 3.7/5

MIT 许可证、版本号 3.32.0、作者署名、维护路径(GitHub issues)、分层文档(SKILL.md + references/examples.md 等)齐备,升级边界(Free vs Pro)披露。扣分点:无 CHANGELOG,references/cli.md 引用的 CLI 仓库与本仓库关系未说明(潜在混淆),版本 3.32.0 但无变更历史佐证,references/marketplace-checks.md 中部分规则与主文件存在轻微重叠。

5有效结果6 / 15 · 2.0/5

核心任务(按 agentskills 规范校验 SKILL.md)规则具体、示例充分、输出格式定义清晰,边际价值明确(替代人工逐条核对)。扣分点:静态审查无法验证代表性输出的正确性与完整性,评分机制(0-100 汇总)仅定义了输出结构未定义计算规则,实际产出仍需人工复核。

6证据核验3 / 10 · 1.5/5

规则配有 worked examples 文件、README 示例输出、独立的 skills.sh/awesome-skills 收录声明。扣分点:无 CI 测试工作流验证检查本身(现有 CI 仅是 Claude 代码审查机器人,不构成执行证据),无第三方独立复现材料,市场收录声明未经本仓库内证据交叉验证。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年9月10日 审查版本 0f24e6cfbca9 评估证据[1][2][3][4][5][6][7]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

运行它需要付费或 API 密钥吗?
不需要。免费层完全离线运行,无需环境变量或 API 密钥;技能本身 MIT 许可。Pro 版(getskillcheck.com)是付费的深度分析产品。
它会修改或删除我的文件吗?
不会。校验是只读的(使用 Read/Glob/Grep),也是幂等的——重复运行对未变更文件产生相同报告。
如果不装文件,能用吗?
可以。在 Claude Desktop/Web 的 Projects 中,把 SKILL.md 中 --- 之后的内容粘贴进自定义指令即可直接运行,无需文件安装。
它能自动修复问题吗?
不能。它只生成报告:每条问题附检查 ID、严重级别、行号和修复建议,修复由你或你的助手手动完成。

相关 Skills