🧠 Skill Router MCP Server

Stop stuffing your LLM's context with everything. Let it fetch what it needs, when it needs it.

A lightweight MCP server that gives AI agents on-demand access to specialized skills — powered by FunctionGemma for smart, cost-effective skill matching.

💡 Why?

LLM context windows are precious (and expensive). Instead of cramming every possible instruction into your system prompt:

Store skills separately in simple markdown files
Let the agent search for relevant skills on-demand
Pay only for what you use — skills load only when needed

Think of it as lazy-loading for AI instructions. 🚀

🔧 How It Works

User: "Create a PowerPoint presentation about cats"
    ↓
Agent: search_skill("PowerPoint presentation slides")
    ↓
FunctionGemma: Matches → "pptx-generator" skill
    ↓
Agent: Receives full instructions + scripts
    ↓
Agent: Executes the task perfectly ✨

FunctionGemma handles the semantic matching — finding the right skill even when the user's words don't exactly match your skill names.

🤖 Core Model: FunctionGemma

This MCP server is powered by FunctionGemma — Google's specialized model for function calling and tool use. FunctionGemma excels at understanding user intent and matching it to the right tools/skills.

Why FunctionGemma?

Purpose-built for function calling — not a general LLM doing tool use as an afterthought
Lightweight — runs locally via Ollama with minimal resources
Fast — optimized for quick semantic matching
Cost-effective — no API costs, runs entirely on your machine

📦 Installation

1. Install Ollama

First, install Ollama for your platform:

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh

# Windows: Download from https://ollama.com/download

2. Pull FunctionGemma Model

ollama pull functiongemma

📖 Model details: ollama.com/library/functiongemma

3. Start Ollama Server

ollama serve

Note: Ollama must be running before starting the Skill Router MCP server.

4. Build Skill Router

cargo build --release

🚀 Usage

# Default skills path (./skills)
./target/release/skill-router-mcp

# Custom skills path
./target/release/skill-router-mcp -s /path/to/skills

⚙️ MCP Configuration

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "skill-router": {
      "command": "/path/to/skill-router",
      "args": ["-s", "/path/to/skills"]
    }
  }
}

Windsurf/Cursor (MCP settings):

{
  "skill-router": {
    "command": "/path/to/skill-router",
    "args": ["-s", "/path/to/skills"]
  }
}

📁 Skill Format

skills/
├── pptx-generator/
│   ├── SKILL.md          # Instructions
│   └── create_pptx.py    # Optional scripts
└── pdf-report/
    └── SKILL.md

SKILL.md example:

---
name: pptx-generator
description: Create PowerPoint presentations from markdown
---

# How to Create a PPTX

1. Use the `create_pptx.py` script
2. Pass markdown content as input
3. ...

🎯 Agent Usage Rules

The server instructs agents to:

Enhance queries with skill categories & technologies before searching
Try up to 3 times with different query variations
Follow skill instructions exactly when found

This maximizes match success while keeping context lean.

🧪 Test It

npx @modelcontextprotocol/inspector ./target/release/skill-router-mcp

🌐 Skills Ecosystem

There's already a rich ecosystem of skills available from Anthropic and the community!

Official Skills (Anthropic)

Browse and use official skills from anthropics/skills:

| Category | Skills | |----------|--------| | Document | docx, pdf, pptx, xlsx | | Design & Creative | algorithmic-art, canvas-design, slack-gif-creator | | Development | frontend-design, artifacts-builder, mcp-builder, webapp-testing | | Communication | brand-guidelines, internal-comms | | Meta | skill-creator |

Community Skills

Explore community-contributed skills at awesome-claude-skills:

obra/superpowers — 20+ battle-tested skills (TDD, debugging, collaboration)
ios-simulator-skill — iOS simulator integration
playwright-skill — Browser automation
claude-d3js-skill — D3.js visualizations
claude-scientific-skills — Scientific computing
Skill_Seekers — Convert docs to skills

Agent Skills Specification

The Agent Skills specification provides a standardized format for skills:

Domain expertise packaging
New capabilities (presentations, MCP servers, data analysis)
Repeatable workflows
Cross-platform interoperability

💡 Tip: Download skills from these repositories into your skills/ folder and let Skill Router find them automatically!

📄 License

MIT — go wild! 🎉

MCP Servers