domains / families / agent-tooling / skill-issue

skill-issue

separate

Find out why a coding-agent skill won't fire — grade each SKILL.md A–F on activation, simulate which skill a prompt triggers, and flag collisions where one silently shadows another.

When to use

• Use when a skill you wrote never seems to trigger and you don't know why
• Use when the user says "why isn't my skill firing", "which skill fires for X", or "audit my skills"
• Use after writing or installing a new SKILL.md, to investigate likely activation issues
• Use in CI to fail a PR that adds a skill with empty/duplicate/colliding metadata

When not to use

• Offline scoring is heuristic and should be treated as a triage signal, not a final quality verdict.
• Collision reports highlight likely shadowing, but agent-specific routers can weight metadata differently.
• The `--fix` mode can improve weak trigger wording, but generated edits still need maintainer review before committing.

Skill page

Source