这个 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 无历史可追溯;发布者身份未经注册库验证。
- 技能仅支持英文说明与输出,中文技能的语义检查适用性未声明。
- 本地文件系统
最简单的方式是通过技能 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?
该技能声明为只读(allowed-tools: Read Glob Grep),无网络访问、无环境变量、无副作用,工作流含执行上限与幂等声明,数据流向清晰。扣分点:发布者身份未经注册库验证,归因仅依赖自述作者字段,无外部回滚/确认机制说明(对只读检查不必要,但安全审计类检查的误报处理仅靠启发式声明)。未发现红线风险。
SKILL.md 自身一致:四步工作流、执行上限、错误处理表、失败反馈(无法读取时在报告中说明)、已知误报披露(4.6 约5%误报)。扣分点:静态审查未执行,无已提交的测试套件覆盖关键检查路径,正则规则(如 Unicode 范围、BiDi 豁免)的正确性无法验证,依赖模型执行启发式检查本身引入不确定性。
触发词明确(check skill、skillcheck、validate SKILL.md),负面触发(排除 Pro/LinkedIn 场景)清晰,输入输出契约明确,完全离线运行对中国大陆网络无依赖问题。扣分点:仅英文,无中文支持声明;对非 Claude Code 环境的部分行为(Claude Code 扩展字段)边界有说明但适用度有限。
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 中部分规则与主文件存在轻微重叠。
核心任务(按 agentskills 规范校验 SKILL.md)规则具体、示例充分、输出格式定义清晰,边际价值明确(替代人工逐条核对)。扣分点:静态审查无法验证代表性输出的正确性与完整性,评分机制(0-100 汇总)仅定义了输出结构未定义计算规则,实际产出仍需人工复核。
规则配有 worked examples 文件、README 示例输出、独立的 skills.sh/awesome-skills 收录声明。扣分点:无 CI 测试工作流验证检查本身(现有 CI 仅是 Claude 代码审查机器人,不构成执行证据),无第三方独立复现材料,市场收录声明未经本仓库内证据交叉验证。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →