skill-routing-audit

Solid

Audits a skill (or all skills) for routing gaps: it holds the right answer but buries it where an agent won't reach it. Targets boundary/negative probes (can it do X, what can't it do, is Y possible) that route to the how-to and miss the answer. Use after authoring or editing a skill, or to sweep all skills.

API & Backend 5 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
26
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Skill Routing Audit A skill can hold the right answer and still fail, because routing buries it. Happy-path "how do I X" questions route to the right reference. Boundary and negative questions ("can it even do X?", "what can't it do?", "is Y possible?") route to that same "how to do X" reference, which only lists what the subject can do, so the real "no" sits in another file or nowhere. The reader lands where the routing points and never sees it. This skill hunts that failure with boundary probes and a skill-only simulation. ## When to Use - After authoring or editing a skill, before relying on it. - To sweep every installed skill for the same class of gap. - When a skill that should cover a question gave a vague or wrong answer. Not for creating a skill from scratch (`skill-creator`) or folding a user's manual edit back into a skill. ## Method Point it at a skill's directory. Audit one named skill, or every subdirectory that has a `SKILL.md`. Fan out one read-only subagent per skill (parallel for an all-skills sweep). Each agent: 1. Read the skill's `SKILL.md`, then its reference and bundled files, to learn what it covers and what it says a user can and cannot do. 2. Derive 4 to 6 boundary/negative probes a real user would ask at the edge of the skill's scope: plausibly-impossible actions, off-limits operations, common misconceptions. Not happy-path "how do I X". Ground each in the skill's own subject. 3. Answer each probe using only this skill: start from `SKILL....

Details

Author
uwuclxdy
Repository
uwuclxdy/agenticat
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

skill-auditor

Audit a SKILL.md or REFERENCE file, score it 0–10, identify major and minor findings, and generate copy-paste improvements. Use when reviewing a new skill before merging, auditing an existing skill for gaps, checking cross-skill consistency, or validating that a skill meets the Quality-Engineering-Skills framework standards. Triggers: audit this skill, score this SKILL.md, review reference file, check skill quality, find gaps in skill, validate skill before PR.

13 Updated yesterday
RBraga01
AI & Automation Listed

skill-doctor

Review an existing Claude Agent Skill and bring it up to best-practice standard. Use this when you have a SKILL.md to audit, harden, or improve — it interviews about allowed-tools scoping, data sensitivity (PHI/PII/HIPAA), high-stakes actions, triggering, and install scope, then recommends fixes and applies them on your confirmation. Do NOT use this to write a brand-new skill from scratch (use skill-creator) or to grade a whole repo at once (use the skill-map auditor / skill-audit Action).

0 Updated today
dhk
AI & Automation Listed

skill-doctor

Audit a Claude Code skill or workflow for structural quality, idempotency, and best-practice compliance. Runs 30+ binary checks grounded in Anthropic's official skill authoring docs, Agent Patterns research, and production patterns. Produces a severity-weighted report (FAIL/WARN/NOTE). Use when the user says 'audit this skill', 'check my skill', 'skill-doctor', 'review my workflow', or provides a path to a skill directory. Do NOT use for codebase audits (use meta-audit) or PRD reviews (use meta-review-prd).

3 Updated 3 days ago
arthjean