Skill Auto Router
Run a lightweight preflight before non-trivial work so the agent loads the right skills instead of guessing.
Quick Start
1) Pre-task routing (before work starts)
python scripts/skill_router.py --task "<user task text>"
This returns ranked skill candidates with match reasons.
2) Daily audit (once per day)
python scripts/skill_router.py --daily
This reports:
- discovered skill count
- duplicate/overlapping trigger language
- weak or vague descriptions that reduce trigger quality
Recommended Integration
To make this behavior automatic, wire it into your workspace steering:
- In
AGENTS.mdpre-task checklist: run pre-task routing for non-trivial tasks. - In
HEARTBEAT.md: run--dailyonce per day and log result.
Use references/setup-checklist.md for copy/paste snippets.
Operating Rules
- Prefer top 1-3 matching skills only (avoid loading everything).
- If no good match is found, continue without skill load.
- If multiple matches tie, choose the most specific skill description.
- Never claim a skill was loaded unless it actually was.
scripts/
scripts/skill_router.py— deterministic local matcher + daily audit
references/
references/setup-checklist.md— integration snippets for AGENTS/HEARTBEAT