convez.ai
MCP ServerIntegração & APIsIntermediário
gengirish

Skills MCP - Descoberta e Instalação de Skills

gengirish/skills-mcp

Catálogo de 7k+ skills para agentes IA com busca, recomendação e instalação

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que indexa ~7.000 agent skills de múltiplos repositórios GitHub e permite que agentes de IA os descubram, busquem e instalem diretamente em IDEs como Cursor, Claude Desktop e Cline. Oferece busca facetada, recomendações contextuais e instalação automática de skills.

Instalação

$npx convez-ai gengirish/skills-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
11
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
v1.0.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Descobrir e integrar skills especializadas para tarefas específicas em IDEs
  • Expandir capacidades de agentes IA com novos domínios (ML, DevOps, dados, etc)
  • Automatizar instalação de skills sem gerenciamento manual de repositórios

Veredito

MCP server maturo e bem integrado que resolve o problema real de descoberta e instalação de skills em massa. Cobertura ampla (11 repos, 20 domínios) e zero-latency search via catálogo pré-compilado. Recomendado para quem quer expandir agentes IA com extensibilidade declarativa.

README

A tradução para o português deste README ainda está na fila.

skills-mcp

An MCP server that lets any AI agent discover, search, and install ~7,000 agent skills from across the GitHub ecosystem (Anthropic, Superpowers, wshobson, antigravity, Composio, antfu, TerminalSkills, and more).

npm version License: MIT


What it does

The Model Context Protocol (MCP) lets editors like Cursor, Claude Desktop, Claude Code, Cline, Continue, Windsurf, and OpenCode plug in external tool providers. This server provides:

ToolPurpose
search_skillsFree-text + faceted search (domain / repo / tier)
get_skillFetch the full SKILL.md content from upstream GitHub
recommend_skills"I want to add Stripe to Next.js" → ranked skill suggestions
list_domainsAll 20 logical domains with skill counts
list_reposAll source repositories with counts and links
install_skillDownload a skill folder into your IDE's skills directory
catalog_statsVersions, generation time, totals

Plus a resource (skills://catalog) exposing the full JSON index.


Quick stats

Skills indexed6,998
Source repositories11
Logical domains20 (testing, security, devops, ai-ml, frontend, backend, data, marketing, docs, …)
Top domainAI/ML/LLM (3,923 skills)
Top repoantigravity-awesome-skills (4,293 skills)

The catalog is built directly from upstream GitHub repos (no local clones needed) by scripts/build-catalog.mjs and shipped inside the npm package — so search_skills has zero network latency. get_skill and install_skill fetch live from GitHub on demand.


Installation

Cursor

Edit ~/.cursor/mcp.json (or per-project .cursor/mcp.json):

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "@gengirish/skills-mcp"]
    }
  }
}

Restart Cursor. The agent will auto-discover the tools.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "@gengirish/skills-mcp"]
    }
  }
}

Claude Code (CLI)

claude mcp add skills npx -y @gengirish/skills-mcp

Cline (VS Code extension)

In Cline's settings → MCP Servers, add:

{
  "skills": {
    "command": "npx",
    "args": ["-y", "@gengirish/skills-mcp"]
  }
}

Continue

In ~/.continue/config.yaml:

mcpServers:
  - name: skills
    command: npx
    args: ["-y", "@gengirish/skills-mcp"]

Windsurf / OpenCode / others

Any MCP-compatible client: spawn the binary npx -y @gengirish/skills-mcp over stdio.

Optional: avoid GitHub rate limits

get_skill and install_skill hit GitHub. Anonymous = 60 req/hr, authenticated = 5,000 req/hr. Set:

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "@gengirish/skills-mcp"],
      "env": { "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx" }
    }
  }
}

A token with no scopes (read-only public access) is sufficient.


Usage examples

Once installed, talk to your agent naturally:

"Use the skills tool to find me skills related to Stripe payments."

"Recommend skills for building a Next.js app with auth and a Postgres database."

"Install the systematic-debugging skill into my Cursor."

"Show me everything tagged 'security' from the wshobson repo."

The agent will call the appropriate tool and act on the results.

Direct tool calls (for power users / scripts)

{
  "tool": "search_skills",
  "arguments": { "query": "kubernetes deploy", "domain": "devops", "limit": 5 }
}
{
  "tool": "install_skill",
  "arguments": {
    "id": "anthropic-skills/skills/skill-creator/SKILL.md",
    "ide": "cursor"
  }
}

ide accepts: cursor (default), claude-code, claude, codex, windsurf, opencode, or custom (with explicit target_dir).


Source repositories indexed

RepoSkillsTier
zebbern/antigravity-awesome-skills4,293Mega bundle
TerminalSkills/skills998Cross-tool
ComposioHQ/awesome-claude-skills864Curated
alirezarezvani/claude-skills540Production teams
wshobson/agents151Plugin marketplace
spencerpauly/awesome-cursor-skills64Cursor-native
obra/superpowers-skills31Framework
anthropics/skills18Official
antfu/skills17Curated
obra/superpowers14Framework
gmh5225/awesome-skills8Curated

Domains

Each skill is automatically tagged into one or more of:

testing · debugging · security · devops · data · ai-ml · frontend · mobile · backend · documents · git-collab · performance · design · marketing-content · business-pm · automation · meta-skills · documentation · blockchain · other

Tagging rules live in scripts/classify.mjs (shared by the catalog builder and the Explorer UI's adapter).


Local development

git clone https://github.com/gengirish/skills-mcp
cd skills-mcp
npm install
GITHUB_TOKEN=ghp_xxx npm run build:catalog   # ~5–10 min first time
npm run build                                 # compile TS
npm run inspect                               # MCP Inspector
node scripts/smoke-test.mjs                   # JSON-RPC smoke test

A fine-grained PAT with public-repo read access is enough. Without it, GitHub limits unauthenticated requests to 60 req/hr — the build will still work for tiny subsets via --only=… but won't complete a full refresh.

Project layout:

skills-mcp/
├── src/
│   ├── index.ts        # MCP server (tools + resources)
│   ├── catalog.ts      # JSON catalog loader
│   ├── search.ts       # Fuse.js fuzzy search + filters
│   └── fetcher.ts      # GitHub raw + API download logic
├── scripts/
│   ├── build-catalog.mjs   # GitHub-native catalog builder
│   ├── classify.mjs        # shared domain classification rules
│   ├── smoke-test.mjs      # JSON-RPC stdio smoke test
│   └── test-install.mjs    # end-to-end install test
├── sources.json        # declarative list of upstream repos + globs
├── .cache/             # per-repo SHA-keyed cache (gitignored)
├── data/
│   └── catalog.json    # generated, ~5 MB (committed)
└── dist/               # tsc output (published)

Refreshing the catalog

# Incremental: only fetches repos whose HEAD SHA changed.
GITHUB_TOKEN=ghp_xxx npm run build:catalog

# Full refetch (ignore .cache/):
GITHUB_TOKEN=ghp_xxx npm run build:catalog -- --force --report

# A single repo:
npm run build:catalog -- --only=anthropic-skills

# Include the giant aggregator (~227k entries; very slow):
npm run build:catalog -- --include-registry

Adding a new source: append an entry to sources.json with {key, owner, repo, branch, label, tier, upstream, include}. Re-run npm run build:catalog and the new repo's skills appear automatically.

Automated daily refresh

The included GitHub Actions workflow (.github/workflows/refresh-catalog.yml) runs daily at 06:00 UTC, refreshes the catalog, commits any diff back to main. Manual trigger with --force / --include-registry toggles is available via "Run workflow".


Publishing

The package is set up for public npm publish.

# bump version
npm version patch     # or minor / major

# publish (this runs prepublishOnly = build:catalog + build)
npm publish --access public

To submit to MCP discovery registries:

  • mcp.so — open a PR adding an entry
  • Smithery — npx -y @smithery/cli install @gengirish/skills-mcp
  • claude-plugins.dev — opens an issue/PR to add the server
  • Glama AI MCP directory — auto-indexed from npm

How it works under the hood

  1. scripts/build-catalog.mjs reads sources.json, hits the GitHub Trees API once per source, fetches each SKILL.md over raw.githubusercontent.com (with concurrency + per-repo SHA cache), parses YAML frontmatter, applies the shared regex-based domain classifier, and writes data/catalog.json (~5 MB).
  2. MCP server loads the catalog at startup, runs Fuse.js fuzzy search in-memory, and uses the upstream coordinates (owner/repo/branch/path) to fetch raw SKILL.md content or recursively download skill folders via the GitHub Contents API on demand.

The catalog is small enough to ship in the npm tarball so search_skills has zero network latency. No local clones of any upstream repo are required at any stage.


License

MIT (this server). Indexed skills retain their upstream licenses — see each source repo. Anthropic's document skills (docx, pdf, pptx, xlsx) are source-available; check before redistribution.

Ver o original no GitHub

Bom para

Relacionados