openskills MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Runtime de Rust — rápido, predecible
Enlaces TS y Python para incrustar en cualquier agente
Revelación progresiva: metadatos → cuerpo → scripts solo cuando sea necesario
Aislamiento de sandbox vía Seatbelt (macOS) y WASM experimental
Entre agentes: no vinculado a Claude Code

Demo en vivo

Cómo se ve en la práctica

openskills-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "openskills-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "openskills-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Geeksfino/openskills",
          "~/.claude/skills/openskills"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add openskills-skill -- git clone https://github.com/Geeksfino/openskills ~/.claude/skills/openskills

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: openskills

Cómo incrustar Agent Skills en tu propio runtime de agente

👤 Ingenieros que construyen agentes LLM personalizados ⏱ ~120 min advanced

Cuándo usarlo: Estás escribiendo un agente desde cero y quieres un sistema de skills que ya entienda SKILL.md.

Requisitos previos

Toolchain de Rust (para construir) o binding precompilado — rustup install stable; o usa el binding TS/Python
Repositorio clonado — git clone https://github.com/Geeksfino/openskills ~/.claude/skills/openskills

Flujo

Instala el binding

Instala el binding openskills de Python o TS y apúntalo a mi directorio de skills.✓ Copiado

→ Runtime cargado; skills enumeradas
Expón a tu agente

Conecta el runtime en el planificador de mi agente para que considere skills en cada paso.✓ Copiado

→ El agente tiene una abstracción SkillRegistry
Ejecuta en sandbox

Habilita el aislamiento de sandbox con Seatbelt para scripts de skills en macOS.✓ Copiado

→ Los scripts de skills se ejecutan bajo perfil de sandbox

Resultado: Tu agente personalizado puede cargar y ejecutar paquetes SKILL.md como lo hace Claude Code.

Errores comunes

Cargar todos los scripts al inicio mata la memoria — Confía en la revelación progresiva — metadatos primero
El sandbox niega operaciones legítimas — Audita el perfil de Seatbelt; estrecharse primero y luego ampliar en lugar de denegar todo por defecto

Combinar con: filesystem

Ejecuta una skill de forma aislada para probarla fuera de Claude Code

👤 Autores de skills que quieren validación entre agentes ⏱ ~45 min intermediate

Cuándo usarlo: Quieres demostrar que tu skill funciona sin el harness específico de Claude Code.

Flujo

Carga la skill

Carga ~/.claude/skills/my-skill/ con openskills e imprime sus metadatos.✓ Copiado

→ Frontmatter + cuerpo parseados
Invoca con un prompt

Aliméntalo con una tarea de muestra y observa qué se cargaría.✓ Copiado

→ Traza de divulgación: lo que el agente vería

Resultado: Confianza en que tu skill se comporta de forma portable.

Errores comunes

La skill depende de internals de Claude Code — Refactoriza la skill para que se base solo en la interfaz pública SKILL.md

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

openskills-skill + skill-optimizer-skill

Valida skills de forma portable antes de optimizarlas

Carga la skill con openskills, luego pásala a skill-optimizer para sugerencias de parches.✓ Copiado

openskills-skill + filesystem

Opera en el directorio de skills directamente

Lista todos los SKILL.md en ~/.claude/skills/, resume cada uno.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
skill-loader	directorio de skills	Inicio del agente	mínimo
progressive-disclosure	id de skill + etapa	Durante el razonamiento del agente	mínimo
sandbox-runner	script + política	Cada vez que una skill genera un subproceso	runtime del script

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: ninguno
Tokens por llamada: el runtime es ligero en prompts; tú controlas qué se divulga
Monetario: gratuito, código abierto
Consejo: Mantén la revelación progresiva activada — cargar cada script de antemano agota el contexto

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: ninguno a nivel de runtime

Salida de datos: ninguno más allá de lo que los scripts mismos hagan

El aislamiento de sandbox WASM es experimental — no confíes en él para scripts adversarios
Los perfiles de Seatbelt deben ajustarse según tu caso de uso

Resolución de problemas

Errores comunes y soluciones

La importación del binding falla

Asegúrate de que el binario nativo coincida con tu plataforma; reconstruye desde el origen si es necesario.

El sandbox bloquea syscalls esperadas

Itera en el perfil de Seatbelt; registra rechazos para encontrar la lista de permisos correcta.

Alternativas

openskills vs otros

Alternativa	Cuándo usarla	Contrapartida
Claude Code native skill loader	Solo estás ejecutando dentro de Claude Code	Sin portabilidad entre agentes

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills