Skillselion MCP server

<h1 align="center">Skillselion MCP</h1>

<p align="center"> <a href="https://skillselion.com"><img src="https://raw.githubusercontent.com/skillselion/skillselion-mcp/master/assets/skillselion-site.png" alt="skillselion.com - the #1 directory of Claude Code, Codex & Cursor skills, marketplaces & MCP servers: 86,207 tools total" width="92%"></a> </p> <p align="center">_{The catalog behind it: <a href="https://skillselion.com"><b>skillselion.com</b></a> - 86,000+ skills, plugin marketplaces &amp; MCP servers, ranked by real installs.}</p>

<p align="center"> <a href="https://www.npmjs.com/package/skillselion-mcp"><img src="https://img.shields.io/npm/v/skillselion-mcp?style=flat-square&color=0891b2&label=npm" alt="npm version"></a> <a href="https://www.npmjs.com/package/skillselion-mcp"><img src="https://img.shields.io/npm/dm/skillselion-mcp?style=flat-square&color=5b7fb0&label=downloads" alt="npm downloads"></a> <img src="https://img.shields.io/badge/read--only-no_auth-6fae7d?style=flat-square" alt="Read-only, no auth"> <a href="https://skillselion.com"><img src="https://img.shields.io/badge/catalog-thousands_of_tools-e0a23a?style=flat-square" alt="thousands of tools"></a> <a href="https://github.com/skillselion/skillselion-mcp/blob/master/LICENSE"><img src="https://img.shields.io/github/license/skillselion/skillselion-mcp?style=flat-square" alt="License"></a> </p>

<p align="center"> <b>Give your coding agent thousands of community-proven skills - loaded on demand, mid-task.</b><br> It searches <a href="https://skillselion.com">Skillselion</a>, a curated directory of Claude Code skills, MCP servers &amp; marketplaces ranked by real installs,<br> and pulls a skill's <b>actual instructions + bundled files</b> into the session. Proven patterns, not guesses. </p>

<p align="center"> 🧩 Works with <b>Claude Code</b> · <b>Claude Desktop</b> · <b>Cursor</b> · <b>Codex</b> · any MCP client </p>

<p align="center"> <img src="https://raw.githubusercontent.com/skillselion/skillselion-mcp/master/assets/demo.gif" alt="Real session: the agent calls synthesize_skills and builds a consensus playbook from 5 community skills" width="92%"> </p> <p align="center">_{Real, unedited session: the agent pulls a consensus playbook from 5 community skills, then loads the top skill and applies it.}</p>

🚀 Install

Claude Code - one line:

claude mcp add skillselion --scope user -- npx -y skillselion-mcp

Claude Desktop / Cursor / Codex - add to your MCP config:

{ "mcpServers": { "skillselion": { "command": "npx", "args": ["-y", "skillselion-mcp"] } } }

No build step, no auth, no API key. One ~30 KB file via npx.

Want it fully automatic? npx -y skillselion-mcp setup registers the server and installs a session hook so your agent loads the right skill the moment a task matches - see Skill autopilot.

🔧 Tools

| Tool | What it does | |------|--------------| | 📥 load_skill | The everyday default: finds the best-matching skill for your task and materializes it - real SKILL.md in context + bundled scripts/references on disk - so the agent follows it like an installed skill. Returns ranked runner-ups you can switch to. | | 🧬 synthesize_skills | The cross-source playbook: merges the key rules of the top ~5 matching skills into one deduped, provenance-tagged digest - the field's consensus, not one author's take. | | 🔍 search_skillselion | Search the catalog by keyword or task; filter by skill / mcp / marketplace. | | 🏆 top_skillselion | The leaderboard - the most-installed skills and top-starred MCP servers right now. |

<p align="center"> <img src="https://raw.githubusercontent.com/skillselion/skillselion-mcp/master/assets/shot-honest.png" alt="Claude's own honest take after using the MCP: consensus across 5 community skills is the part I can't fake" width="92%"> </p> <p align="center">_{We asked Claude, on camera, what the MCP gave it: <i>"I couldn't have told you 'this is the field's consensus, not my opinion' - that's the part I can't fake."</i>}</p>

🔒 Private by default

Read-only, no auth, no secrets. It never sends your code, files, or the context you pass - only a scrubbed search query + which skill matched, so the catalog learns what to add next. Set DO_NOT_TRACK=1 to disable even that.

🪄 Skill autopilot

npx -y skillselion-mcp setup        # interactive - pick your packs
npx -y skillselion-mcp setup --yes  # non-interactive - agents / CI

Registers the MCP globally and installs a Claude Code SessionStart hook that primes every session with skills relevant to you - so loads happen on their own.

<details> <summary><b>Setup flags & packs</b></summary>

| Flag | What it does | |---|---| | --packs <a,b,…> | one or more packs (or all), e.g. --packs frontend,backend; frontend:6 sets a per-pack count | | --per-pack N | skills per pack (default 3) · --top N sets the popular count | | --auto | adapt each session to the current repo's stack | | --history | infer your focus from Claude Code / Codex history (one-time scan) | | --yes | never prompt (default when there's no terminal) |

Packs: popular (default) · frontend · ai-agents · media · backend · devops · quality · automation.

Safe by design: ~/.claude/settings.json is merged, never clobbered; re-running de-dupes and upgrades the hook in place. </details>

<details> <summary><b>Env vars</b></summary>

| Var | Default | What it controls | |-----|---------|------------------| | GITHUB_TOKEN | - | optional, read-only; raises GitHub's rate limit for full multi-file skill loads (60 → 5000 req/hr) | | SK_INLINE_BUDGET | 6000 | char cap on the in-context SKILL.md portion (the full skill is always on disk) | | SK_SYNTH_N | 5 | how many top skills synthesize_skills merges (2-8) | | SK_SYNTH_PER_SKILL | 12 | max rules kept per source skill | | SK_SYNTH_BUDGET | 4000 | char cap on the merged digest | | DO_NOT_TRACK | - | set 1 to disable the anonymous demand signal | </details>

<details> <summary><b>Troubleshooting</b></summary>

The agent doesn't see the tools. Some clients surface MCP tools lazily - tell the agent to search its tools for "skillselion" first (e.g. ToolSearch), then call it. The setup hook automates this nudge.

load_skill returns only the SKILL.md, no bundled files. You hit GitHub's unauthenticated 60 req/hr limit - set a read-only GITHUB_TOKEN in the server's env.

"No skill on Skillselion clearly matches..." The relevance floor working as intended - nothing topical matched, so it refuses to waste your context. Try a more specific query.

Setup couldn't auto-register. Run the printed claude mcp add ... line yourself. </details>

<details> <summary><b>Development</b></summary>

npm install
npm test           # offline: server boots, tools, synthesis
npm run test:live  # live catalog + GitHub (set GITHUB_TOKEN)

</details>

⭐ Like it?

• Star the repo - it helps other developers find it.
• Browse the full catalog → skillselion.com - thousands of skills, MCP servers & marketplaces, ranked by real installs.
• Bug or missing skill? Open an issue - PRs welcome.

📄 License

MIT © Skillselion

<p align="center"> _{Built for developers. Find the skill, not the noise. → <a href="https://skillselion.com/skillselion-mcp">skillselion.com/skillselion-mcp</a>} </p>