| name | skill-router |
| description | Use for every user request when SkillSpec router mode is enabled. First check the local SkillSpec router index, load the selected skill only when route decision is use_skill, and continue with normal agent behavior when the decision is bypass or ambiguous. |
| metadata | {"routing":{"tags":["skills","router","discovery","codex","claude"],"triggers":["choose the right skill","route to a skill","many skills installed","skill descriptions shortened","install skill router","disable implicit skill invocation"],"negative_triggers":["ordinary code generation"]}} |
Skill Router
This skill is a thin native harness loader for the SkillSpec router.
When router mode is enabled and the harness has been restarted, this router is
the first hop for every user request in managed skill roots. All routed skills
are explicit-only/manual-only, so check the router index before reading,
searching for, or guessing at a domain skill.
The router does not execute task work. It decides whether a local skill should
be loaded, reports confidence and candidate paths, and asks for direct or
durable execution only after a use_skill decision when the task will use tools
and the user has not already chosen an execution mode.
Runtime Contract
-
For ordinary requests with prompt-hook context first_hop_ready=true, use the fast path: do not read ./skill.spec.yml and do not run skillspec router index status.
-
Run one route query:
skillspec route --index <index-file-or-router-dir> --query '<user task>' --top 5 --json
-
If route output says decision: "use_skill" and is non-null, read that skill's and follow it.
