skills-master-mcp

<h1 align="center">skills-master-mcp</h1>

<p align="center"> <a href="https://www.npmjs.com/package/skills-master-mcp"><img src="https://img.shields.io/npm/v/skills-master-mcp?color=blue&label=npm" alt="npm version" /></a> <a href="https://www.npmjs.com/package/skills-master-mcp"><img src="https://img.shields.io/npm/dm/skills-master-mcp?color=green" alt="npm downloads" /></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-yellow" alt="License: MIT" /></a> <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="Node.js" /></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple" alt="MCP Compatible" /></a> </p>

<p align="center"> <a href="#quick-start">Quick Start</a>  •  <a href="#example">Example</a>  •  <a href="#tools">Tools</a>  •  <a href="#how-it-works">Architecture</a>  •  <a href="#supported-agents">Agents</a> </p>

---

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

<details> <summary>Full parameter reference</summary>

search

Parameter	Type	Default	Description
query	string	required	Search terms
page	number	1	Page number
limit	number	20	Results per page (max: 100)
sort_by	string	"stars"	"stars" or "recent"
response_format	string	"markdown"	"markdown" or "json"

ai_search

Parameter	Type	Default	Description
query	string	required	Natural language query
response_format	string	"markdown"	"markdown" or "json"

read_skill

Parameter	Type	Default	Description
owner	string	required	GitHub user/org
repo	string	required	Repository name
path	string	—	Path to skill folder
branch	string	"main"	Git branch

install_skill

Parameter	Type	Default	Description
source	string	required	GitHub owner/repo or full URL
skills	string	required	Skill names (comma-separated)
agents	string	required	Target agents (comma-separated)
global	boolean	false	Install globally (user-level)

remove_skill

Parameter	Type	Default	Description
skills	string	required	Skill names to remove (comma-separated)
agent	string	"claude-code"	Target agent
global	boolean	false	Remove from global scope

</details>

---

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