sorcerai/skill-router

Lazy-loader MCP server for Claude Code skills: search/load on demand instead of preloading the whole library

About skill-router

A lazy router for Claude Code skills: instead of every installed skill costing context every turn, expose the whole library through three small MCP tools — search, load, reindex. Weak/cheap models navigate it fine; that's the point.

Single-file Node MCP server (stdio). One dependency (@modelcontextprotocol/sdk). No database, no embeddings, no background services. Indexing ~185 skills takes ~25ms at startup.

On startup (and on skillreindex) the server walks three roots for SKILL.md files:

Root Label Notes --------- ~/.claude/skills/ active symlinks followed (with cycle guard) ~/.claude/plugins/ plugin plugins/cache/ and plugins/marketplaces/ excluded ~/.claude/skill-vault/ vault see below

Frontmatter name:/description: are parsed (including YAML block scalars like description: -); duplicates dedupe with precedence active plugin vault.

- skillsearch {query, limit?} — ranked {id, name, description, source, path, score}. Token-overlap scoring with query-side stopword filtering (so "make my website load faster" still finds web-perf), whole-query substring boost, and partial name-fragment credit ("website" matches the name web-perf). - skillload {id} — full SKILL.md content plus sibling files (references/, scripts/, …). Accepts ids or names case-insensitively; unknown ids return the 5 closest matches instead of an error. - skillreindex — rescan, returns counts per source.

The real context win: move rarely-used skills from ~/.claude/skills/ into ~/.claude/skill-vault/. The harness stops listing them every turn, but they stay fully discoverable and loadable through the router

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/sorcerai--skill-router.html)

Related MCP servers