skill-router-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@skill-router-mcp recommend skills for code review"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Skill Router MCP
Skill Router MCP is a local, read-only router for large collections of agent skills. It indexes installed SKILL.md files, searches their metadata and workflows, reports duplicate definitions, and recommends a transparent candidate set to an AI agent.
The router does not execute skills and does not make the final choice. It returns:
primary candidates;
complementary skills;
additional candidates that might otherwise be hidden by a small result limit;
invocation mode (
automatic,manual-only, or unspecified);matching evidence and duplicate paths.
No LLM, embedding API, account, telemetry, or network call is used for routing.
MCP tools
inventory_skills— summarizes indexed roots, invocation modes, duplicate names, and read errors.search_skills— deterministic scored search for a capability or task.recommend_skills— proposes primary, complementary, and additional candidates while leaving the decision to the agent.explain_skill— returns metadata and duplicate locations for an exact skill name.
All tools are declared read-only and idempotent.
Related MCP server: SkillSearch
Requirements
Node.js 20 or newer.
An MCP client with local stdio support, such as Cursor.
Install
npm install -g https://github.com/Agent-Nova-107/skill-router-mcp/archive/refs/heads/main.tar.gzAdd the server to Cursor's user MCP configuration:
{
"mcpServers": {
"skill-router": {
"command": "skill-router-mcp"
}
}
}Install the optional agent skill:
npx skills add Agent-Nova-107/skill-router-mcp --global --agent cursor --yesCopy cursor/skill-routing.mdc to ~/.cursor/rules/skill-routing.mdc if you want Cursor to consult the router automatically for ambiguous or complex tasks.
Restart Cursor after changing MCP configuration.
Indexed locations
By default the server checks:
~/.agents/skills/
~/.cursor/skills/
<current-directory>/.agents/skills/
<current-directory>/.cursor/skills/Override this list with SKILL_ROUTER_PATHS, using the operating system's normal path separator (; on Windows, : on Unix):
$env:SKILL_ROUTER_PATHS = "C:\skills;D:\team-skills"Symbolic links are not followed. Skill files larger than 256 KiB and traversal deeper than eight directories are rejected.
Routing model
Routing is deterministic:
Parse YAML frontmatter and invocation metadata.
Normalize English and French task terms.
Score name, description, workflow text, and lifecycle intent separately.
Collapse duplicate names while exposing every duplicate path.
Return a broad candidate pool divided into primary, complementary, and additional sections.
Scores rank candidates; they are not probabilities or quality ratings.
Security and limitations
Tools accept task text and skill names, not arbitrary filesystem paths.
The server only reads the configured skill roots.
Prompt text inside a skill is treated as searchable data, never executed.
Keyword routing can miss semantic relationships or rank generic descriptions too highly.
A recommendation proves relevance only, not quality, freshness, compatibility, or safety.
The AI agent must inspect the task, codebase, and selected skill before acting.
Development
npm ci
npm run check
npm test
npm run buildTo smoke-test the stdio server with the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.jsLicense
MIT
Available Tools
4 toolsexplain_skillExplain an installed skillARead-onlyIdempotent
Return metadata and duplicate locations for an exact installed skill name without executing it or dumping its full prompt.
Inputs: name (required).
inventory_skillsInventory installed skillsARead-onlyIdempotent
Index installed SKILL.md files and summarize roots, invocation modes, duplicate names, and read errors. Read-only.
Inputs: includeDuplicatePaths.
recommend_skillsRecommend a skill flowARead-onlyIdempotent
Recommend primary, complementary, and additional installed skills for a task. Advisory only; the AI agent retains the final decision and additional candidates are not hidden.
Inputs: task (required), primaryLimit, candidateLimit.
search_skillsSearch installed skillsARead-onlyIdempotent
Search installed skills deterministically by task terms. Returns scored candidates and reasons without choosing for the agent.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Tools are mostly distinct in purpose: inventory summarizes the index, search finds candidates, recommend provides ranked suggestions, and explain returns metadata. However, search_skills and recommend_skills overlap notably in that both surface candidate skills for a task, with the difference (scored candidates vs. categorized recommendations) subtle enough that an agent could misselect. inventory_skills and explain_skill also both touch metadata/duplicate info.
All four tools follow a consistent verb_noun pattern (inventory, search, recommend, explain) that is clear and readable. The verbs are varied but each communicates a distinct action well, and the noun 'skills' is consistent. Minor inconsistency: 'inventory' as a verb is slightly unconventional vs. the more standard 'list', but the pattern remains coherent.
Four tools is a reasonable, focused count for a skill-routing server whose purpose is discovery/indexing/advisory. Each tool earns its place covering distinct stages of the workflow. Could arguably be slightly slim, but it's well-scoped and not overly heavy.
The surface covers indexing, searching, recommending, and explaining skills, which covers the core discovery workflow well. However, there's no tool for skill management operations (e.g., installing, removing, or updating skills), and no filter-by-category listing tool—gaps that agents might hit when they need to act on skills rather than just discover them. Still, for a routing/advisory purpose the surface is largely complete.
Related MCP Connectors
Search, fetch, lint, and install Agent Skills (SKILL.md) from the SkillMD registry.
Agent skills for Claude, Codex and Cursor: find, install and load skills from one connector.
Search your team's shared AI-skill library, get install commands, and save skills from your agent.
Find AI agent skills: public previews and source links. Read-only discovery; no account required.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to dynamically discover and execute tools through a structured skills system. Serves as a documentation hub where skills are defined in directories, allowing progressive loading and interpretation of capabilities.MIT
- AlicenseNot gradedqualityDmaintenanceIndexes every skill across all installed plugins and enables the agent to find them instantly via BM25 search through an MCP tool.6 npm2MIT
- AlicenseNot gradedqualityDmaintenanceEnables coding agents to search, recommend, and validate a stack of reusable skills from a local catalog, producing deterministic plans without modifying the project.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to install compatible SKILL.md skills from Git repositories or local directories into a persistent registry, then discover them through search, progressive loading, and asset reads. It exposes only user-selected hot skills as individual activation tools, keeping execution and trust decisions under explicit operator control.MIT