{
  "markdown": "<h1 align=\"center\">Skillselion MCP</h1>\n\n<p align=\"center\">\n  <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>\n</p>\n<p align=\"center\"><sub>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.</sub></p>\n\n<p align=\"center\">\n  <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>\n  <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>\n  <img src=\"https://img.shields.io/badge/read--only-no_auth-6fae7d?style=flat-square\" alt=\"Read-only, no auth\">\n  <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>\n  <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>\n</p>\n\n<p align=\"center\">\n  <b>Give your coding agent thousands of community-proven skills - loaded on demand, mid-task.</b><br>\n  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>\n  and pulls a skill's <b>actual instructions + bundled files</b> into the session. Proven patterns, not guesses.\n</p>\n\n<p align=\"center\">\n  🧩 Works with <b>Claude Code</b> · <b>Claude Desktop</b> · <b>Cursor</b> · <b>Codex</b> · any MCP client\n</p>\n\n<p align=\"center\">\n  <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%\">\n</p>\n<p align=\"center\"><sub>Real, unedited session: the agent pulls a consensus playbook from 5 community skills, then loads the top skill and applies it.</sub></p>\n\n## 🚀 Install\n\n**Claude Code** - one line:\n\n```bash\nclaude mcp add skillselion --scope user -- npx -y skillselion-mcp\n```\n\n**Claude Desktop / Cursor / Codex** - add to your MCP config:\n\n```json\n{ \"mcpServers\": { \"skillselion\": { \"command\": \"npx\", \"args\": [\"-y\", \"skillselion-mcp\"] } } }\n```\n\nNo build step, no auth, no API key. One ~30 KB file via `npx`.\n\nWant 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](#-skill-autopilot).\n\n## 🔧 Tools\n\n| Tool | What it does |\n|------|--------------|\n| 📥 **`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. |\n| 🧬 **`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. |\n| 🔍 **`search_skillselion`** | Search the catalog by keyword or task; filter by `skill` / `mcp` / `marketplace`. |\n| 🏆 **`top_skillselion`** | The leaderboard - the most-installed skills and top-starred MCP servers right now. |\n\n<p align=\"center\">\n  <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%\">\n</p>\n<p align=\"center\"><sub>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></sub></p>\n\n## 🔒 Private by default\n\nRead-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.\n\n## 🪄 Skill autopilot\n\n```bash\nnpx -y skillselion-mcp setup        # interactive - pick your packs\nnpx -y skillselion-mcp setup --yes  # non-interactive - agents / CI\n```\n\nRegisters 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.\n\n<details>\n<summary><b>Setup flags & packs</b></summary>\n\n| Flag | What it does |\n|---|---|\n| `--packs <a,b,…>` | one or more packs (or `all`), e.g. `--packs frontend,backend`; `frontend:6` sets a per-pack count |\n| `--per-pack N` | skills per pack (default 3) · `--top N` sets the `popular` count |\n| `--auto` | adapt each session to the current repo's stack |\n| `--history` | infer your focus from Claude Code / Codex history (one-time scan) |\n| `--yes` | never prompt (default when there's no terminal) |\n\nPacks: `popular` *(default)* · `frontend` · `ai-agents` · `media` · `backend` · `devops` · `quality` · `automation`.\n\nSafe by design: `~/.claude/settings.json` is merged, never clobbered; re-running de-dupes and upgrades the hook in place.\n</details>\n\n<details>\n<summary><b>Env vars</b></summary>\n\n| Var | Default | What it controls |\n|-----|---------|------------------|\n| `GITHUB_TOKEN` | - | optional, read-only; raises GitHub's rate limit for full multi-file skill loads (60 → 5000 req/hr) |\n| `SK_INLINE_BUDGET` | `6000` | char cap on the in-context `SKILL.md` portion (the full skill is always on disk) |\n| `SK_SYNTH_N` | `5` | how many top skills `synthesize_skills` merges (2-8) |\n| `SK_SYNTH_PER_SKILL` | `12` | max rules kept per source skill |\n| `SK_SYNTH_BUDGET` | `4000` | char cap on the merged digest |\n| `DO_NOT_TRACK` | - | set `1` to disable the anonymous demand signal |\n</details>\n\n<details>\n<summary><b>Troubleshooting</b></summary>\n\n**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.\n\n**`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`.\n\n**\"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`.\n\n**Setup couldn't auto-register.** Run the printed `claude mcp add ...` line yourself.\n</details>\n\n<details>\n<summary><b>Development</b></summary>\n\n```bash\nnpm install\nnpm test           # offline: server boots, tools, synthesis\nnpm run test:live  # live catalog + GitHub (set GITHUB_TOKEN)\n```\n</details>\n\n## ⭐ Like it?\n\n- **[Star the repo](https://github.com/skillselion/skillselion-mcp)** - it helps other developers find it.\n- **Browse the full catalog → [skillselion.com](https://skillselion.com)** - thousands of skills, MCP servers & marketplaces, ranked by real installs.\n- Bug or missing skill? **[Open an issue](https://github.com/skillselion/skillselion-mcp/issues)** - PRs welcome.\n\n## 📄 License\n\n[MIT](./LICENSE) © [Skillselion](https://skillselion.com)\n\n<p align=\"center\">\n  <sub>Built for developers. Find the skill, not the noise. → <a href=\"https://skillselion.com/skillselion-mcp\">skillselion.com/skillselion-mcp</a></sub>\n</p>\n",
  "bytes": 7703,
  "sha": "0cea7b46a2aef9a2400ce5d6afff5def4e1d2927405a0e82b8ef770242f76244",
  "repo_slug": "skillselion/skillselion-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_skillselion_skillselion_mcp_86fcee14/readme"
}