Skill Routers

Skill Routers are how agents discover domain skills mid-conversation. Each router groups related skills behind a short recruitment blurb; the agent reads the blurbs, pulls the router that matches the conversation, and then picks a skill from the router’s contents. You can find the management page under Configuration > Skill Routers in the sidebar.

The routers list

Each row shows the router’s key, its blurb, whether it is active, whether it currently appears in the manifest (the router list injected into agent system prompts), and how many of its mapped skills are actually live in selection versus merely mapped.

Admins can create a router with New Router. The router key is immutable after creation; the display name and blurb can be edited later.

Router detail

Opening a router shows its mapped skills. A skill only renders in the selection payload when all three conditions hold:

1. its mapping is approved,
2. the skill itself is active, and
3. the skill has an approved disambiguation description.

The “Renders in Payload” column shows which condition fails for non-rendering skills (hover over why?).

• Add skill maps an approved skill under the router. Admin mappings are approved immediately. Re-adding a previously rejected mapping re-approves it.
• Remove deletes the mapping. If it was the skill’s only router, the skill becomes unreachable and shows up in the unrouted-skills banner.
• Descriptions opens the skill’s disambiguation description history — the text the agent reads when choosing among a router’s skills. Submitting a new version (admin) takes effect immediately.
• What the LLM sees previews the exact selection payload for this router, as the agent receives it.

Retiring a router

Routers are never deleted — Retire deactivates one, removing it from the manifest immediately. Skills mapped only under a retired router become unreachable via selection until mapped elsewhere (or the router is reactivated).