作者扫了200份Skill文件，发现95%没写“何时该用”。写Agent Skill时记得加Use when，不然智能体不知道啥时候调用。
@bharath31_ 从GitHub抓取200个公开的SKILL.md文件，用Tripwire的lint引擎扫描发现96%存在至少一个lint错误，仅4%完全无错误。在171个有效Skill中，95%（163个）缺少“Use when…”激活条件说明。这类Skill只描述功能，没写明何时触发，导致Agent难以在合适时机调用。问题根源在于Agent Skills规范2025年才开放，90天内已有30多个工具支持，skills.sh上有约9万个Skill，但description仍是自由文本，没有编译器或测试来检查。
95% 的 Agent Skill 少了一句"什么时候该用它" 作者 @bharath31_ 从 GitHub 抓取了 200 个公开的 SKILL.md 文件，用 Tripwire 的 lint ...
95% 的 Agent Skill 少了一句"什么时候该用它" 作者 @bharath31_ 从 GitHub 抓取了 200 个公开的 SKILL.md 文件，用 Tripwire 的 lint 引擎扫描，结果是： · 96% - 至少存在一个 lint 错误 · 4% - 完全无错误 · 95%（163 个）- 缺少 "Use when…" 激活条件说明（在 171 个有效 Skill 中） 典型的失败模式是：只写了 Skill 是什么（"一个帮助写测试的工具"），却省略了何时该被激活（"当用户添加测试、查看失败的测试、或提到覆盖率时使用"）。相当于只贴了标签，却把路由信号写得很弱。 为什么这个问题会大面积出现？ 归因于生态的爆发式增长与工具链缺失的错位： · Agent Skills 规范于 2025 年开放 · 约 90 天内，30+ 个 Agent 工具（Codex、Gemini CLI、VS Code、Cursor、Goose 等）完成支持 · skills.sh 上已有约 9 万个 Skill · 但 description 这个路由字段至今仍是一个自由文本字符串——没有编译器、没有测试、没有编辑器警告，作者写偏了得不到任何反馈 Richard Seroter @rseroter 95% of agent skills are missing a key instruction. Which one? Few skills include the "use when" directive that tells the agent the right time to activate a skill. Good reminder from @bharath31_ : bharath.sh/writing/agent-… 🔗 View Quoted Tweet 💬 2 🔄 0 ❤️ 1 👀 285 📊 2 ⚡