Skill Router MCP

🚀 Skill Router MCP Server

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

🚀 Quick Start

This lightweight MCP server offers AI agents on - demand access to specialized skills. It's powered by FunctionGemma for smart and cost - effective skill matching.

✨ Features

💡 Why?

LLM context windows are both precious and expensive. Instead of stuffing every possible instruction into your system prompt:

1. Store skills separately in simple markdown files.
2. Let the agent search for relevant skills on - demand.
3. 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 Examples

Basic Usage

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

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

📚 Documentation

⚙️ 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:

1. Enhance queries with skill categories & technologies before searching.
2. Try up to 3 times with different query variations.
3. 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:

Community Skills

Explore community - contributed skills at [awesome - claude - skills](https://github.com/travisvn/awesome - claude - skills):

• obra/superpowers — 20+ battle - tested skills (TDD, debugging, collaboration).
• [ios - simulator - skill](https://github.com/conorluddy/ios - simulator - skill) — iOS simulator integration.
• [playwright - skill](https://github.com/lackeyjb/playwright - skill) — Browser automation.
• [claude - d3js - skill](https://github.com/chrisvoncsefalvay/claude - d3js - skill) — D3.js visualizations.
• [claude - scientific - skills](https://github.com/K - Dense - AI/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.

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

📄 License

MIT — go wild! 🎉