🎯 Skills MCP Server - Global Command Integration

Exposes 1,334 skills as global MCP tools in Claude Desktop, VSCode, Cursor, and any compatible client

What it does

• 📚 Automatically discovers all skills in c:\skills (live, no rebuild required)

• 🗂️ Categorizes 1,334 skills into 18 categories with dedicated commands per category

• 🔧 Exposes 24 MCP tools: 18 category-based + 6 general (including BM25 semantic search)

• 🌐 Works in Claude Desktop, VSCode Copilot, Cursor, GitHub Copilot

Related MCP server: Skillz

Architecture

c:\skills\                    ← 1300+ skills (cada uma com SKILL.md)
         ├── agent-customization/
         │   └── SKILL.md
         ├── react-best-practices/
         │   └── SKILL.md
         └── ...

c:\mcp\                       ← MCP Server
     ├── mcp_server.py          ← Servidor principal (24 tools, FastMCP)
     ├── categorize_skills.py   ← Utilitário de auditoria de categorias
     ├── categories.json        ← Snapshot de categorias para auditoria
     ├── sync_cursor_rules.py   ← Sincroniza CLAUDE.md → Cursor User Rules
     ├── setup.py               ← Configura clientes automaticamente
     ├── pyproject.toml         ← Dependências (uv)
     ├── requirements.txt       ← Dependências (pip)
     └── README.md

Setup - 3 quick steps

1️⃣ Install dependencies

# Recomendado (uv)
cd c:\mcp
uv sync

# Alternativa (pip)
pip install -r requirements.txt

2️⃣ Run setup

cd c:\mcp
python setup.py

Or using the PowerShell script (recommended for Windows):

.\setup.ps1

This automatically configures:

• ✅ Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json)

• ✅ Cursor (~\.cursor\mcp.json)

• 📝 Displays instructions for VSCode

3️⃣ Restart applications

Restart Claude Desktop, Cursor, and/or VSCode to load the server.

Available tools (24 total)

By category (18 tools)

Each tool lists only the skills in that category, with an icon and count.

All accept the parameter limit: int = 0 (0 = returns all in the category)

General (6 tools)

Usage examples

# Listar skills de AI
list_ai_skills()
→ 🤖 AI & Agentes — 129 skills: agent-evaluation, agent-memory-mcp, ...

# Invocar uma skill específica
invoke_skill("react-best-practices", "como usar hooks corretamente?")
→ [retorna conteúdo completo do SKILL.md]

# Buscar por palavra
search_skills("docker")
→ [lista todas as skills com "docker" no nome]

# Ver todas as categorias
list_categories()
→ ♿ accessibility (8) | 🤖 ai (129) | ⚙️ backend (80) | ...

Skill categorization

Skills are automatically categorized by folder name using token rules, prefixes, and substrings defined in mcp_server.py (dict CATEGORY_RULES).

To verify categories after adding new skills:

python categorize_skills.py

Runtime categorization is performed directly by the server — categories.json is just a snapshot for auditing.

Current distribution (March 2026):

• 🚀 devops: 233 | 🤖 ai: 168 | 🔄 automation: 153 | ✅ testing: 109

• ⚙️ backend: 94 | 🎨 frontend: 91 | 📝 content: 88 | 🔒 security: 81

• 💻 language: 63 | 🏗️ architecture: 60 | 💼 business: 33 | 📱 mobile: 27

• 📊 data: 22 | ♿ accessibility: 9 | 🔗 web3: 8 | 🎮 gamedev: 7

• 📦 other: 298 (meta/personal skills without technical category)

• 77.7% of skills categorized into specific categories

Structure of a SKILL.md

# Nome da Skill

Descrição brevíssima do que a skill faz.

## Uso

Como usar, exemplos, contexto...

The server reads the title (H1), extracts metadata, and uses the full content as context.

Adding a new skill

1. Create the folder: c:\skills\{skill-name}\

2. Create the file: c:\skills\{skill-name}\SKILL.md

3. Run python categorize_skills.py to update the category cache

4. The server discovers the skill on the next call (no restart required)

Troubleshooting

Skills not appearing

python -c "from mcp_server import get_skills; print(len(get_skills()))"

Claude Desktop / Cursor not connecting

1. Check uv in PATH: uv --version

2. Check the config: %APPDATA%\Claude\claude_desktop_config.json

3. Completely restart the client

VSCode not recognizing tools

• Check settings.json (see output of python setup.py)

• Restart VSCode

Slash Commands per Client

Dynamic Global Memory

Sync rules with Cursor

# Ver o que será gravado (dry-run)
python c:/mcp/sync_cursor_rules.py --show

# Sincronizar (feche o Cursor antes)
python c:/mcp/sync_cursor_rules.py

# Limpar
python c:/mcp/sync_cursor_rules.py --clear

Links

• 📖 MCP Spec 2025-11-25

• 🚀 FastMCP Docs

• 🧩 VSCode MCP Guide

• 🖱️ Cursor MCP Guide

Created: March 26, 2026
Updated: March 29, 2026
Version: 2.2
Skills: 1,334 | Categories: 18 | MCP Tools: 24
Status: ✅ Production ready