Skill router

Skill AnamKwon/agent-skill-router/plugins/skill-router/skills/skill-router

Cross-agent skill router that organizes large local skill libraries into category routers and loads leaf skills on demand.

Install

npx -y skills add AnamKwon/agent-skill-router --skill skill-router

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
10 stars10 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use to organize a large skill library into category routers, route new skills, and propose new categories when existing routers are insufficient.

SKILL.md

3.1 KB, as published. Nobody here has run it

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.
Run node plugins/skill-router/scripts/skill-router.mjs apply only after the plan is coherent.
Run node plugins/skill-router/scripts/skill-router.mjs scan and node plugins/skill-router/scripts/skill-router.mjs validate.

New Category Test

Create a new category only when at least one of these is true:

A skill would need mismatched special cases in every existing category.
Three or more unclassified or awkwardly classified skills share the same distinct workflow force.
Expanding an existing category would make its Avoid rules vague.
The new category can name clear use_when, avoid_when, and leaf routes.

Routing Plan Shape

Write plans as JSON with categories and routes. skill-router.mjs apply is deterministic; the agent owns judgment, and the script only applies the approved plan.

{
  "categories": [
    {"id": "category-id", "display": "Category Name", "short": "Short focus", "description": "When to use first", "routing_prompt": "How to choose a leaf", "avoid": ["When not to use it"]}
  ],
  "routes": [
    {"category": "category-id", "skill": "leaf-skill", "reason": "Why this leaf belongs here"}
  ]
}

Stop

The skill description is too generic to classify from inventory metadata.
Existing categories fit for unrelated reasons and no dominant force is clear.
The plan creates a catch-all category such as misc, general, or other.
Applying the plan would hide a useful distinction that the user needs for routing.