SkillDB

Biblioteca pesquisável com mais de 5.900 habilidades de agente — 10 ferramentas MCP; o plano gratuito fornece metadados, e uma chave de API gratuita desbloqueia o conteúdo completo das habilidades. Streamable HTTP remoto em mcp.skilldb.dev.

GitHub

Experimente este MCPPatrocinado

Documentação

skilldb

CLI, SDK TypeScript e Servidor MCP para SkillDB — descubra, instale e gerencie habilidades de agentes de IA.

Mais de 5.900 habilidades especializadas em 429 pacotes para Claude Code, Cursor, Windsurf, VS Code e qualquer ferramenta de IA compatível com MCP.

Código aberto para transparência. Este é o código-fonte completo do pacote npm skilldb — o CLI e o servidor MCP que rodam na sua máquina e lidam com sua chave de API. Ele é publicado no npm via Trusted Publishing (OIDC, com proveniência), então o artefato publicado é verificavelmente construído a partir deste repositório. Audite à vontade, e PRs são bem-vindos. Licença MIT.

Servidor MCP

Conecte o SkillDB diretamente à sua ferramenta de codificação de IA via Model Context Protocol:

# Step 1 (optional): install globally. You can also skip this — the npx form below works without it.
npm install -g skilldb

# Step 2: Get your free API key at https://skilldb.dev/api-access

# Step 3: Add to Claude Code (with API key for full content)
claude mcp add skilldb -- npx -p skilldb skilldb-mcp --api-key sk_live_YOUR_KEY

Nota: skilldb-mcp é um binário dentro do pacote skilldb, não um pacote npm próprio — sempre invoque como npx -p skilldb skilldb-mcp (não npx skilldb-mcp).

⚠️ Sem uma chave de API, você pode pesquisar e navegar pelas habilidades (somente metadados). Com uma chave de API gratuita, você obtém o conteúdo completo das habilidades — as instruções markdown reais que seu agente usa. Obtenha sua chave em 30 segundos em skilldb.dev/api-access.

Cursor — adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "skilldb": {
      "command": "npx",
      "args": ["-p", "skilldb", "skilldb-mcp"]
    }
  }
}

Windsurf — adicione ao mcp_config.json:

{
  "mcpServers": {
    "skilldb": {
      "command": "npx",
      "args": ["-p", "skilldb", "skilldb-mcp", "--api-key", "sk_live_xxx"]
    }
  }
}

VS Code — em uma linha:

code --add-mcp '{"name":"skilldb","command":"npx","args":["-p","skilldb","skilldb-mcp"]}'

Ou adicione o mesmo bloco de servidor ao .vscode/mcp.json (workspace) / usuário mcp.json em "servers".

Depois de conectado, seu assistente de IA pode pesquisar e carregar habilidades nativamente. Basta pedir:

"Pesquise no SkillDB por padrões de performance em React"
"Carregue a habilidade de revisão de código"
"Quais habilidades devo usar para este projeto?"
"Salve isso como uma habilidade privada" (plano Studio — veja abaixo)

10 ferramentas expostas: skilldb_search, skilldb_get, skilldb_list, skilldb_suggest, skilldb_recommend, skilldb_purge, skilldb_set_key (defina/troque sua chave de API no meio da sessão, sem reiniciar), e as ferramentas de habilidades privadas skilldb_my_skills, skilldb_create_skill, skilldb_update_skill (plano Studio + chave com escopo de escrita).

Início Rápido (CLI)

# Search for skills (with inline preview)
npx skilldb search "code review"

# Install a skill pack
npx skilldb add software-skills

# Activate a smart profile (only loads what you need)
npx skilldb use frontend

# Or auto-detect from your project
npx skilldb use auto

Instalação

npm install -g skilldb

Ou use npx skilldb sem instalar.

O Problema da Memória (E Como o Resolvemos)

Carregar 500 habilidades no contexto do seu agente é pior do que carregar as 5 certas. O SkillDB usa uma arquitetura de 3 camadas para gerenciar isso:

.skilldb/
├── skills/          ← Full cache (everything downloaded)
├── active/          ← Active profile (what your agent sees — 5-15 focused skills)
├── slim/            ← Compressed cheat sheets (10x smaller)
├── config.json      ← Profile + budget settings
└── manifest.json    ← What's installed

Seu CLAUDE.md ou .cursorrules aponta para .skilldb/active/, não para o cache completo. O agente recebe habilidades focadas e relevantes — não ruído.

Comandos do CLI

Núcleo

`skilldb init`

Detecta seu IDE (Claude Code, Cursor, Codex CLI, OpenClaw), cria .skilldb/ e adiciona a configuração de integração.

skilldb init

`skilldb search <query>`

Pesquisa habilidades por palavra-chave. Mostra uma prévia enxuta inline para você saber o que está obtendo antes de baixar.

skilldb search "debugging"
skilldb search "api design" --category "Technology & Engineering"
skilldb search "testing" --limit 10

`skilldb add <pack>`

Baixa um pacote de habilidades para o cache local. Idempotente — ignora habilidades já em cache.

skilldb add software-skills
skilldb add autonomous-agent-skills
skilldb add vibe-coding-security-skills

`skilldb get <id>`

Baixa uma única habilidade.

skilldb get software-skills/code-review

`skilldb info <id>`

Mostra metadados, resumo enxuto e prévia completa de uma habilidade.

skilldb info software-skills/code-review

`skilldb list`

Lista categorias, pacotes e habilidades disponíveis.

skilldb list
skilldb list --category "Autonomous Agents"
skilldb list --pack software-skills

`skilldb login`

Solicita sua chave de API e a salva em ~/.skilldbrc (para o usuário) para que todos os projetos a encontrem via a cadeia de resolução em Autenticação. A alternativa recomendada em vez de definir SKILLDB_API_KEY manualmente.

skilldb login

Carregamento Inteligente

`skilldb use <profile>`

Ativa um perfil focado — carrega apenas habilidades relevantes em .skilldb/active/.

skilldb use frontend          # React, testing, web-polish, accessibility
skilldb use backend           # API design, databases, security, performance
skilldb use devops            # Kubernetes, Docker, CI/CD, monitoring
skilldb use security          # Trust audit, input validation, credentials
skilldb use data              # SQL, pipelines, analytics, visualization
skilldb use fullstack         # Frontend + backend combined
skilldb use mobile            # Mobile / React Native / app development
skilldb use ai-agent          # Autonomous agent meta-skills
skilldb use auto              # Auto-detect from your project files
skilldb use --list            # Show available profiles
skilldb use --current         # Show active profile
skilldb use none              # Deactivate (clear active/)

O modo auto examina seu package.json, extensões de arquivo e imports para recomendar o perfil certo.

`skilldb budget`

Define um orçamento máximo de contexto para que seu agente não fique sobrecarregado.

skilldb budget                # Show current usage
skilldb budget set 5000       # Max 5,000 lines
skilldb budget set 50k        # Max 50,000 tokens
skilldb budget optimize       # Re-rank and trim active skills to fit

`skilldb slim`

Gera versões compactadas em formato de cola das habilidades (~30 linhas em vez de 300).

skilldb slim                  # Slim all active skills
skilldb slim software-skills  # Slim a specific pack
skilldb slim --ratio 0.3      # Keep 30% of content

Gerenciamento

`skilldb update`

Verifica se há versões mais recentes das habilidades instaladas e as atualiza.

skilldb update                # Update everything
skilldb update software-skills  # Update one pack

`skilldb remove`

Desinstala habilidades do cache local.

skilldb remove software-skills/code-review    # Remove single skill
skilldb remove software-skills                # Remove entire pack
skilldb remove --unused                       # Remove skills not in active profile

`skilldb doctor`

Verificação de integridade e auditoria da sua configuração de habilidades.

skilldb doctor

Mostra: habilidades desatualizadas, habilidades não utilizadas, dependências ausentes, status do orçamento, lacunas de cobertura.

`skilldb stats`

Painel de estatísticas local.

skilldb stats

Mostra: quantidade instalada, total de linhas, tokens, perfil ativo, categorias cobertas.

`skilldb diff <id>`

Compara sua versão local (possivelmente personalizada) com a versão remota mais recente.

skilldb diff software-skills/code-review
skilldb diff                  # Diff all installed

`skilldb purge`

Remove habilidades em cache para liberar espaço em disco.

skilldb purge --inactive      # Remove skills not in the active profile
skilldb purge --all           # Remove ALL cached skills (including active)
skilldb purge --slim          # Also drop slim summaries
skilldb purge --dry-run       # Preview what would be removed, delete nothing

Habilidades Privadas (Studio)

Crie habilidades que somente você (e as pessoas com quem você as compartilha) pode ler. Elas aparecem nos seus próprios resultados de pesquisa quando você está autenticado. Criar/editar exige o plano Studio e uma chave de API com escopo de escrita — crie uma em skilldb.dev/account#api-keys.

`skilldb push <file.md>`

Cria (ou atualiza) uma habilidade privada a partir de um arquivo Markdown local. O nome da habilidade usa o nome do arquivo por padrão; o título é resolvido como flag --title → primeiro # H1 do Markdown → nome do arquivo.

skilldb push ./my-react-patterns.md                    # create (pack defaults to "personal")
skilldb push ./my-react-patterns.md -p team --tags react,perf
skilldb push ./my-react-patterns.md --update           # update the skill with the same name/pack

Opções: -p, --pack, -n, --name, -t, --title, -d, --description, --tags <comma,list>, -u, --update.

`skilldb my-skills`

Lista suas habilidades privadas (as que você possui mais as compartilhadas com você).

skilldb my-skills

Você também pode fazer tudo isso pelo seu agente via as ferramentas MCP skilldb_create_skill / skilldb_update_skill / skilldb_my_skills.

Compartilhamento e Exportação

`skilldb export`

Exporta sua configuração para compartilhamento ou integração com IDE.

skilldb export claude         # CLAUDE.md snippet with skill references
skilldb export cursor         # .cursorrules block
skilldb export profile        # Shareable .skilldb-profile.json
skilldb export inject <id>    # Print skill to stdout (for piping)

`skilldb recommend`

Examina seu projeto e obtém recomendações personalizadas de habilidades.

skilldb recommend             # Analyze project and suggest
skilldb recommend --install   # Auto-install recommendations

Uso do SDK

import { createClient } from 'skilldb';

const db = createClient(); // auto-loads key from env/config

// Search with slim previews
const results = await db.search('code review');
for (const skill of results.skills) {
  console.log(skill.title);
  console.log(skill.slim); // Quick summary
}

// Get full skill content
const skill = await db.get('software-skills/code-review.md');
console.log(skill.content);

// List with filters
const listing = await db.list({ category: 'Autonomous Agents', limit: 10 });

Autenticação

O SDK e o CLI resolvem sua chave de API na seguinte ordem:

Variável de ambiente SKILLDB_API_KEY (amigável para CI)
.skilldbrc na raiz do projeto (específica do projeto)
~/.skilldbrc no diretório inicial (para o usuário)

Níveis de acesso:

Sem chave — navegar e pesquisar (somente metadados).
Chave Pro ou Studio — conteúdo completo das habilidades (as instruções markdown reais).
Chave Studio com escopo write — habilidades privadas (skilldb push / my-skills, e as ferramentas MCP create/update). Chaves somente leitura são rejeitadas com um erro de escopo de escrita. Crie uma chave com escopo de escrita em skilldb.dev/account#api-keys.

Perfis

Os perfis integrados mapeiam conjuntos de habilidades selecionadas:

Perfil	Habilidades carregadas	Melhor para
`frontend`	react-patterns, web-polish, testing, accessibility	Aplicativos React/Vue/Angular
`backend`	api-design, databases, security, performance	Serviços Node/Python/Go
`devops`	kubernetes, docker, ci-cd, monitoring, cloud	Infraestrutura e implantação
`security`	trust-audit, input-validation, credentials, hardening	Revisão e endurecimento de segurança
`data`	sql, pipelines, analytics, visualization	Engenharia e análise de dados
`fullstack`	frontend + backend combined	Aplicações full-stack
`mobile`	mobile patterns, app architecture, UI	Aplicativos mobile / React Native
`ai-agent`	autonomous-agent-skills, task-decomposition, planning	Construção de agentes de IA
`auto`	Detectado a partir do projeto	Qualquer projeto

Requisitos

Node.js >= 18

Licença

MIT