skill-router

# Skill Router Use this skill to organize many local skills without loading every leaf skill body into the model context. The script builds a compact inventory, marks ambiguous or duplicate-description skills for body review, and lets the agent author the final routing plan. ## Check First - Confirm the workspace has `skill-router.config.json`, or set `SKILL_ROUTER_LEAF_ROOTS`, `SKILL_ROUTER_EXPOSED_ROOT`, and `SKILL_ROUTER_ROUTING_ROOT`. - Keep hidden leaf skills separate from exposed category router skills. - Treat BM25 and token-overlap similarity as read-priority hints only. - Read leaf `SKILL.md` bodies only when `routing-review.md` marks them under `Needs Body Review`, the compact metadata is ambiguous, or a category boundary would change. ## Workflow 1. Run `node scripts/skill-router.mjs scan`. 2. Read `routing-review.md`, `skill-inventory.json`, and the current `routing-index.json` from the configured routing root. 3. Reuse existing categories when their `use_when` and `avoid_when` boundaries stay clear. 4. Create a new category only when existing categories would need mismatched special cases or vague avoidance rules. 5. Write `routing-plan.json` with all categories and routes. 6. Run `node scripts/skill-router.mjs apply`, then `scan`, then `validate`. ## Stop When - The same directory is both the hidden leaf root and exposed category root. - A catch-all category such as misc, general, or other would be required. - Classification would be based on keywords instead of workflow force and agent behavior. ## Report Theory(category boundary -> leaf routing) / Changed / Verified / Risk