MCP.so
Sign In

Skills Mcp

@Jignesh-Ponamwar

About Skills Mcp

A semantic skills registry over MCP that teaches AI agents how to do things correctly using curated expert skills that agents discover and load at the moment they need them. You can build your own.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "skill-mcp": {
      "transport": "streamable-http",
      "url": "https://skill-mcp.jigneshponamwar.workers.dev/mcp"
    }
  }
}

Tools

7

ALWAYS CALL THIS FIRST — before any other skills_ tool, no exceptions. This is the ONLY valid source of skill_ids. Do NOT use skill_ids from skills_list_all without first running this search to verify relevance. Returns ranked results with similarity scores. Required next actions: score > 0.6 → call skills_get_body with that skill_id score 0.4–0.6 → read the description, then decide whether to load score < 0.4 → no match, proceed without a skill Query tips: be specific about the task. GOOD: 'implement Stripe webhook signature verification in Python' BAD: 'stripe' — too vague, produces poor matches.

BROWSING — See all available skills without semantic search. Use when you want to explore the full registry by category or tag. WARNING: skill_ids returned here have NOT been scored for relevance to your current task. After browsing, you MUST still call skills_find_relevant to verify relevance before loading any skill with skills_get_body. Do NOT pass skill_ids from this listing directly to skills_get_body. Returns lightweight frontmatter (skill_id, name, tags, complexity_level, has_tier3) to keep token usage reasonable. Supports pagination: use offset to skip results, limit to control batch size.

Load full skill instructions. Call ONLY after skills_find_relevant returns this skill_id with score > 0.6. REQUIRED PREREQUISITES — both must be true before calling this tool: 1. You called skills_find_relevant with a specific query 2. This skill_id appeared in those results with score > 0.6 If either prerequisite is missing, STOP and call skills_find_relevant first. Calling this tool with an unverified skill_id (e.g. one from skills_list_all or a guessed ID) will load a skill that may be completely irrelevant to your task, wasting tokens and producing wrong output. Returns: - instructions: step-by-step expert guidance — read and follow entirely - tier3_manifest: available reference files, scripts, assets After loading: follow the instructions precisely. Call Tier-3 tools ONLY when the instructions explicitly name a specific file.

OPTIONAL — Load config variants and constraints for a skill. REQUIRED PREREQUISITES — all must be true before calling this tool: 1. You called skills_find_relevant and got a score > 0.6 2. The skill_id came from those search results 3. The user asked about configuration, or skills_get_body mentioned options Do NOT call by default. Most tasks complete with skills_get_body alone.

Fetch a reference document bundled with a skill. STRICT PREREQUISITES — ALL THREE must be true before calling this tool: 1. You called skills_find_relevant and received a score > 0.6 2. You called skills_get_body and read the full instructions 3. Those instructions explicitly say 'see FILENAME.md' or 'refer to FILENAME' If any prerequisite is missing, do NOT call this tool. Speculative loading wastes tokens and does not improve task quality. Pass filename='list' to see available reference files for a skill.

Execute a helper script bundled with a skill. STRICT PREREQUISITES — ALL THREE must be true before calling this tool: 1. You called skills_find_relevant and received a score > 0.6 2. You called skills_get_body and read the full instructions 3. Those instructions explicitly direct you to run a specific script file If any prerequisite is missing, do NOT call this tool. Script source is NEVER returned — only stdout, stderr, and exit_code. Scripts run sandboxed in an isolated temp directory with a 30-second timeout. Deployment note: script execution requires the local server. The Cloudflare Workers deployment returns the manifest only. Two-phase use: 1. filename='list' → see available scripts and descriptions 2. filename='<script.py>' + optional input_data → execute

Fetch a template or static resource bundled with a skill (markdown templates, config starters, example data files). STRICT PREREQUISITES — ALL THREE must be true before calling this tool: 1. You called skills_find_relevant and received a score > 0.6 2. You called skills_get_body and read the full instructions 3. Those instructions explicitly reference a specific asset file If any prerequisite is missing, do NOT call this tool. Two-phase use: 1. filename='list' → see the full asset manifest 2. filename='<file>' → fetch content (use as a starting template, adapt to task)

Overview

What is Skills Mcp?

Skills Mcp is a self-hostable registry of expert AI agent skills delivered over MCP (Model Context Protocol). It provides AI agents with a searchable library of curated, step-by-step procedures (skills) for tasks like setting up Stripe webhooks, containerizing Python apps, or writing structured code reviews.

How to use Skills Mcp?

An agent calls skills_find_relevant with a natural language query, receives ranked matches with similarity scores, then loads full instructions via skills_get_body. Self-hosting requires cloning the repository and deploying to Cloudflare Workers with a free Qdrant Cloud cluster and Cloudflare Workers AI credentials; a Docker path is also available for fully local use.

Key features of Skills Mcp

  • Semantic vector search using Cloudflare Workers AI (bge-small-en-v1.5)
  • Three-tier progressive disclosure: discover, load body, fetch supplementary files
  • 30 bundled skills covering Stripe, Supabase, FastAPI, Docker, and more
  • Self-hostable in under 10 minutes with no separate backend or GPU
  • Backed by Qdrant Cloud for vector storage
  • Only descriptions and trigger phrases are embedded; full instructions fetched on demand

Use cases of Skills Mcp

  • AI agent retrieving expert runbooks for software development tasks
  • Automating Stripe subscription setup with webhooks using verified procedures
  • Containerizing a Python application with step-by-step security checklists
  • Writing structured code reviews with common mistake avoidance
  • Generating PDF, Excel, Word, or PowerPoint documents via scripted skills

FAQ from Skills Mcp

What is the core idea behind Skills Mcp?

Instead of hoping an AI agent remembers the right way to perform a task, it gives the agent a searchable library of curated, step-by-step procedures it can pull from on demand.

How does skill discovery work?

Discovery uses semantic vector search (Cloudflare Workers AI) so natural language queries match correctly even when phrasing varies. Only the short description and trigger phrases are embedded; full instructions are fetched separately on demand.

What are the runtime dependencies?

You need a free Cloudflare Workers account, a free Qdrant Cloud cluster, and Cloudflare Workers AI credentials for embeddings. A Docker path is also available for fully local use without cloud services.

What skills are included?

30 bundled skills covering Stripe, Supabase, FastAPI, React, Next.js, Docker, GitHub Actions, Terraform, Cloudflare Workers, Anthropic/OpenAI/Gemini APIs, PDF/Excel/Word/PowerPoint generation, SQL, web scraping, code review, test writing, and MCP server building.

How is the server architected?

It runs as a single Cloudflare Python Worker backed by Qdrant Cloud. A seed script populates six Qdrant collections from SKILL.md files. Nothing is loaded speculatively; agents follow a three-tier progressive disclosure pattern.

Frequently asked questions

What is the core idea behind Skills Mcp?

Instead of hoping an AI agent remembers the right way to perform a task, it gives the agent a searchable library of curated, step-by-step procedures it can pull from on demand.

How does skill discovery work?

Discovery uses semantic vector search (Cloudflare Workers AI) so natural language queries match correctly even when phrasing varies. Only the short description and trigger phrases are embedded; full instructions are fetched separately on demand.

What are the runtime dependencies?

You need a free Cloudflare Workers account, a free Qdrant Cloud cluster, and Cloudflare Workers AI credentials for embeddings. A Docker path is also available for fully local use without cloud services.

What skills are included?

30 bundled skills covering Stripe, Supabase, FastAPI, React, Next.js, Docker, GitHub Actions, Terraform, Cloudflare Workers, Anthropic/OpenAI/Gemini APIs, PDF/Excel/Word/PowerPoint generation, SQL, web scraping, code review, test writing, and MCP server building.

How is the server architected?

It runs as a single Cloudflare Python Worker backed by Qdrant Cloud. A seed script populates six Qdrant collections from `SKILL.md` files. Nothing is loaded speculatively; agents follow a three-tier progressive disclosure pattern.

Comments

More Other MCP servers