| name | skill-router |
| description | Use to organize a large skill library into category routers, route new skills, and propose new categories when existing routers are insufficient. |
Skill Router
Use this router when organizing, reclassifying, or validating a growing skill library.
It keeps first-pass discovery small by routing from exposed category skills to hidden leaf skills.
For third-party installs, configure the target roots explicitly instead of assuming
the plugin is installed inside the same repository as the skills.
Token Budget Rule
Do not read every leaf SKILL.md by default. Start from routing/skill-inventory.json,
routing/routing-review.md, routing/routing-index.json, and the exposed category router
SKILL files. Read a leaf body only when the inventory summary is ambiguous or when moving it
would change a category boundary.
The target skill roots come from skill-router.config.json or environment
variables. For user-global skills, use hidden leaf roots such as
~/.claude/skill-leaves and expose category routers in ~/.claude/skills.
For project skills, use .claude/skill-leaves and .claude/skills.
Workflow
- Run
node plugins/skill-router/scripts/skill-router.mjs scan to refresh compact metadata.
- Read
plugins/skill-router/routing/routing-review.md and existing category routers under plugins/skill-router/skills/.
- Classify by workflow force and stop conditions, not by keyword alone.
- Keep a skill in an existing category only when that category's
Use When and Avoid rules stay clear.
- If no existing category fits without vague wording, propose a new category in
plugins/skill-router/routing/routing-plan.json.