SKILL.md 写完没人调？试试这个给 AI Agent 配置体检的工具

你有没有过这种经历：辛辛苦苦写了一个 SKILL.md，Claude Code 却像看不见一样，根本不调用？或者换个工具就报错，配置明明”看起来对”却死活不生效？最近挖到一个工具——agnix，GitHub 上 376 star、2026 年 8 月刚更新的”AI 编码助手专属 Linter“，专门给 SKILL.md / CLAUDE.md / AGENTS.md / hooks / MCP 配置做体检，447 条规则覆盖 Claude Code、Codex、OpenCode、Cursor、Copilot 全家桶。

它解决的是一个特别隐蔽但杀伤力极大的问题：你的 AI Agent 配置大概率是坏的，你自己根本不知道。Vercel 的研究就发现，skills 在配置错误时调用率直接归零——一个字段写错，整个 skill 就变成了隐形文件。agnix 把这种”沉默失败”翻译成红黄绿三色诊断，写一行命令就能跑全工程扫描：

$ npx agnix .
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful and accurate' [fixable]
.claude/skills/review/SKILL.md:3:1 error: Invalid name 'Review-Code' [fixable]
Found 1 error, 1 warning — 2 issues are automatically fixable

为什么这个工具值得装？

• 覆盖面广：447 条规则来自官方规范、学术论文、真实事故报告，不是拍脑袋凑的清单。
• 多端联动：CLI + GitHub Action + VS Code / JetBrains / Neovim / Zed 全有插件，编辑器里直接划红线。
• 自动修复：支持 --fix、--fix-safe、--fix-unsafe 三档，安全修复默认不动语义。
• 零门槛试玩：官方 Playground 在浏览器里粘贴配置就能看诊断，agent-sh.github.io/agnix/playground 直接用。

实操建议

用 Claude Code / Cursor / Copilot 多工具栈的同学强烈建议装一份到 CI 上——提交时自动卡门禁，不让坏配置混进主干。Skill 作者更值得拥有，写完 SKILL.md 先跑一遍 npx agnix .，保证发布出去别人也能正常触发。整套是 Rust 写的，性能不用担心，大仓库秒级扫描。

装法也简单：npm i -g agnix 或 brew install agnix，VS Code 用户直接在 Marketplace 搜 “agnix”。

https://github.com/agent-sh/agnix

GitHub: https://github.com/agent-sh/agnix