SkillDB

Biblioteca de más de 5,900 habilidades de agentes: 10 herramientas MCP; el nivel gratuito ofrece metadatos, una clave API gratuita desbloquea el contenido completo de las habilidades. HTTP remoto transmisible en mcp.skilldb.dev.

GitHub
1
Prueba este MCPPatrocinado

Documentación

skilldb

CLI, SDK de TypeScript y Servidor MCP para SkillDB — descubre, instala y gestiona habilidades de agentes de IA.

Más de 5.900 habilidades expertas en 429 paquetes para Claude Code, Cursor, Windsurf, VS Code y cualquier herramienta de IA compatible con MCP.

Add SkillDB to Cursor Install in VS Code npm

Código abierto por transparencia. Esta es la fuente completa del paquete npm skilldb — el CLI y el servidor MCP que se ejecutan en tu máquina y gestionan tu clave API. Se publica en npm mediante Trusted Publishing (OIDC, con procedencia), por lo que el artefacto publicado se construye de forma verificable a partir de este repositorio. Audita libremente y las pull requests son bienvenidas. Licencia MIT.

Servidor MCP

Conecta SkillDB directamente a tu herramienta de codificación con IA mediante el 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 es un binario dentro del paquete skilldb, no un paquete npm propio — invócalo siempre como npx -p skilldb skilldb-mcp (no npx skilldb-mcp).

⚠️ Sin clave API, puedes buscar y explorar habilidades (solo metadatos). Con una clave API gratuita, obtienes el contenido completo de las habilidades — las instrucciones markdown reales que usa tu agente. Obtén tu clave en 30 segundos en skilldb.dev/api-access.

Cursor — añade a .cursor/mcp.json:

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

Windsurf — añade a mcp_config.json:

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

VS Code — en una línea:

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

O añade el mismo bloque de servidor a .vscode/mcp.json (espacio de trabajo) / usuario mcp.json bajo "servers".

Una vez conectado, tu asistente de IA puede buscar y cargar habilidades de forma nativa. Solo pregunta:

  • "Busca en SkillDB patrones de rendimiento de React"
  • "Carga la habilidad de revisión de código"
  • "¿Qué habilidades debería usar para este proyecto?"
  • "Guarda esto como una habilidad privada" (plan Studio — ver más abajo)

10 herramientas expuestas: skilldb_search, skilldb_get, skilldb_list, skilldb_suggest, skilldb_recommend, skilldb_purge, skilldb_set_key (establece/cambia tu clave API a mitad de sesión, sin reiniciar), y las herramientas de habilidades privadas skilldb_my_skills, skilldb_create_skill, skilldb_update_skill (plan Studio + clave con alcance de escritura).

Inicio 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

Instalación

npm install -g skilldb

O usa npx skilldb sin instalar.

El problema de la memoria (y cómo lo resolvemos)

Cargar 500 habilidades en el contexto de tu agente es peor que cargar las 5 correctas. SkillDB usa una arquitectura de 3 capas para gestionar esto:

.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

Tu CLAUDE.md o .cursorrules apunta a .skilldb/active/, no a la caché completa. El agente recibe habilidades enfocadas y relevantes — no ruido.

Comandos CLI

Núcleo

skilldb init

Detecta tu IDE (Claude Code, Cursor, Codex CLI, OpenClaw), crea .skilldb/ y añade la configuración de integración.

skilldb init

skilldb search <query>

Busca habilidades por palabra clave. Muestra una vista previa reducida en línea para que sepas lo que obtienes antes de descargar.

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

skilldb add <pack>

Descarga un paquete de habilidades a la caché local. Idempotente — omite las habilidades ya almacenadas en caché.

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

skilldb get <id>

Descarga una sola habilidad.

skilldb get software-skills/code-review

skilldb info <id>

Muestra metadatos, resumen reducido y vista previa completa de una habilidad.

skilldb info software-skills/code-review

skilldb list

Lista las categorías, paquetes y habilidades disponibles.

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

skilldb login

Solicita tu clave API y la guarda en ~/.skilldbrc (a nivel de usuario) para que cada proyecto la recoja mediante la cadena de resolución en Autenticación. La alternativa recomendada a establecer SKILLDB_API_KEY manualmente.

skilldb login

Carga inteligente

skilldb use <profile>

Activa un perfil enfocado — solo carga habilidades relevantes en .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/)

El modo auto escanea tu package.json, extensiones de archivo e imports para recomendar el perfil adecuado.

skilldb budget

Establece un presupuesto máximo de contexto para que tu agente no se sobrecargue.

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

Genera versiones comprimidas tipo chuleta de las habilidades (~30 líneas en lugar 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

Gestión

skilldb update

Comprueba si hay versiones más recientes de las habilidades instaladas y actualízalas.

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

skilldb remove

Desinstala habilidades de la caché 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

Comprobación de estado y auditoría de tu configuración de habilidades.

skilldb doctor

Muestra: habilidades desactualizadas, habilidades sin usar, dependencias faltantes, estado del presupuesto, brechas de cobertura.

skilldb stats

Panel de estadísticas local.

skilldb stats

Muestra: cantidad instalada, líneas totales, tokens, perfil activo, categorías cubiertas.

skilldb diff <id>

Compara tu versión local (posiblemente personalizada) con la última versión remota.

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

skilldb purge

Elimina habilidades en caché para liberar espacio en 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)

Crea habilidades que solo tú (y las personas con las que las compartas) puedes leer. Aparecen en tus propios resultados de búsqueda cuando estás autenticado. Crear/editar requiere el plan Studio y una clave API con alcance de escritura — genera una en skilldb.dev/account#api-keys.

skilldb push <file.md>

Crea (o actualiza) una habilidad privada desde un archivo Markdown local. El nombre de la habilidad se establece por defecto al nombre del archivo; el título se resuelve como bandera --title → primer # H1 de Markdown → nombre del archivo.

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

Opciones: -p, --pack, -n, --name, -t, --title, -d, --description, --tags <comma,list>, -u, --update.

skilldb my-skills

Lista tus habilidades privadas (las que posees más las que se han compartido contigo).

skilldb my-skills

También puedes hacer todo esto desde tu agente mediante las herramientas MCP skilldb_create_skill / skilldb_update_skill / skilldb_my_skills.

Compartir y exportar

skilldb export

Exporta tu configuración para compartirla o para integración con 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

Escanea tu proyecto y obtén recomendaciones de habilidades personalizadas.

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

Uso del 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 });

Autenticación

El SDK y el CLI resuelven tu clave API en este orden:

  1. Variable de entorno SKILLDB_API_KEY (compatible con CI)
  2. .skilldbrc en la raíz del proyecto (específico del proyecto)
  3. ~/.skilldbrc en el directorio de inicio (a nivel de usuario)

Niveles de acceso:

  • Sin clave — explorar y buscar (solo metadatos).
  • Clave Pro o Studio — contenido completo de las habilidades (las instrucciones markdown reales).
  • Clave Studio con alcance write — habilidades privadas (skilldb push / my-skills, y las herramientas MCP create/update). Las claves de solo lectura se rechazan con un error de alcance de escritura. Crea una clave con alcance de escritura en skilldb.dev/account#api-keys.

Perfiles

Los perfiles integrados se asignan a conjuntos de habilidades seleccionadas:

PerfilHabilidades cargadasIdeal para
frontendreact-patterns, web-polish, testing, accessibilityAplicaciones React/Vue/Angular
backendapi-design, databases, security, performanceServicios Node/Python/Go
devopskubernetes, docker, ci-cd, monitoring, cloudInfraestructura y despliegue
securitytrust-audit, input-validation, credentials, hardeningRevisión y endurecimiento de seguridad
datasql, pipelines, analytics, visualizationIngeniería y análisis de datos
fullstackfrontend + backend combinedAplicaciones full-stack
mobilemobile patterns, app architecture, UIAplicaciones móviles / React Native
ai-agentautonomous-agent-skills, task-decomposition, planningConstrucción de agentes de IA
autoDetectado desde el proyectoCualquier proyecto

Requisitos

  • Node.js >= 18

Licencia

MIT