skills-master-mcp

Quick Start  •  Example  •  Tools  •  Architecture  •  Agents

What is this?

A Plug & Play MCP server that connects your AI coding agent to the SkillsMP marketplace - 8,000+ community-made skills.

You can search for skills, easily install them (to ~/.claude/skills/) or read them directly into your agent's context (without installing).
No API key needed.
One command to set up.

The key idea is to help lazy people like me to use skills more often, and save time and tokens for our dear agents.

Example

Here’s a real use case: converting a Markdown file to PDF.
You can either have the agent learn how to do it via web search, or simply import the skill.
Super efficient and fast.

You:      "I need to convert README.md to a PDF"

Agent:    searches SkillsMP for "markdown to pdf"
          → finds a skill for it
          → reads the SKILL.md content from GitHub
          → now has the full instructions in context

Agent:    "I found a skill for this. It uses Puppeteer to render
           the markdown and save it as PDF. Let me do that now."

          ...converts your file using the skill's instructions.

You:      ":))))"

The skill was never installed to your ~/.claude/skills
The agent just read it, learned the approach, and executed it.
One-shot use.

If you want a skill permanently, you can install it too:

You:      "Install that markdown-to-pdf skill for Claude Code"

Agent:    runs install_skill
          → skill is now saved to .claude/skills/
          → available in every future conversation

Quick Start

No API key
No .env
No configuration
Just install and run

Claude Code

claude mcp add skills-master -- npx skills-master-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "skills-master": {
      "command": "npx",
      "args": ["skills-master-mcp"]
    }
  }
}

Any MCP-Compatible Client

npx skills-master-mcp

Tools

| Tool | Input | Output | |------|-------|--------| | search | keywords (e.g., "react testing") | List of matching skills with name, author, stars, links | | ai_search | plain English (e.g., "how to build REST APIs") | Semantically relevant skills ranked by relevance | | read_skill | GitHub owner + repo + path | The skill's full SKILL.md content, loaded into agent context | | install_skill | GitHub source + skill names + target agents | Skill permanently saved to agent's skills directory | | remove_skill | skill names | Deletes the skill files from agent's skills directory |

Supported Agents

| Agent | Install | Remove | |-------|---------|--------| | Claude Code | Yes | Yes | | Cursor | Yes | Yes | | Codex | Yes | — | | OpenCode | Yes | — | | GitHub Copilot | Yes | — | | Roo | Yes | — | | Antigravity | Yes | — |

How It Works

Your AI Agent
    │
    ▼
skills-master-mcp (local, via npx)
    ├── search / ai_search ──▶ Proxy Backend ──▶ SkillsMP API
    ├── read_skill ──────────▶ GitHub (direct)
    ├── install_skill ───────▶ npx add-skill
    └── remove_skill ────────▶ Local file deletion

Search requests go through a proxy backend so you don't need an API key. Everything else is direct.

Configuration

Nothing to configure. Optional env vars for advanced use:

| Variable | Default | Description | |----------|---------|-------------| | SKILLS_MASTER_BACKEND_URL | Production URL | Override backend endpoint | | TRANSPORT | stdio | stdio or http | | PORT | 3000 | HTTP port (when TRANSPORT=http) |

Links

• SkillsMP Marketplace
• npm Package
• skills CLI
• MCP Specification

License

MIT