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 |
Full parameter reference
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 |
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
License
MIT