| name | skill-auto-router |
| description | Automatically discover and route relevant installed skills for the current task, plus run a daily skill audit. Use when you want pre-task skill matching across installed skills, heartbeat-based daily relevance checks, or help wiring "auto-skill selection" into AGENTS/HEARTBEAT workflows. |
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.md pre-task checklist: run pre-task routing for non-trivial tasks.
- In
HEARTBEAT.md: run --daily once 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
