用途：审计编码智能体的技能激活面。智能体依据技能常驻的名称与描述决定调用哪个技能，技能实现无误但描述过于笼统时可能永不触发，或被更具体的同类技能静默压过。skill-issue 专门审计这一层。
主要能力：为目录中每个技能按激活表现打 A–F 分，汇总冲突；针对给定提示模拟哪个技能会触发及原因；输出互相遮蔽的技能冲突簇；--fix 为薄弱描述追加“Use when …”触发语句；--json 输出机器可读结果并在出错时返回非零退出码。默认使用离线启发式评分，加 --llm 可交由本地 claude/codex 命令行判断。
使用方式：先安装 CLI，npm i -g @misha_misha/skill-issue、brew install mishanefedov/skill-issue/skill-issue 或 npx @misha_misha/skill-issue，然后运行如 skill-issue ~/.claude/skills 评分，skill-issue ~/.codex/skills --why "deploy to prod" 查看触发，skill-issue <dir> --collisions 查看遮蔽簇，skill-issue <dir> --fix 追加触发语句，skill-issue <dir> --json 获取机器可读结果。
适用场景：自写技能总不触发时排查原因；用户询问“为什么我的技能不生效”“X 会触发哪个技能”“审计我的技能”时；编写或安装新 SKILL.md 后确认能否被选中；在 CI 中阻止新增空、重复或冲突元数据的技能合入。
限制：离线评分属启发式，只应作为分诊信号而非最终质量结论；冲突报告只指出可能的遮蔽，不同智能体的路由对元数据权重可能不同；--fix 能改善弱触发措辞，但生成的修改在提交前仍需维护者复核。