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

Por qué usarlo

Características clave

Instala desde URL de GitHub o repositorio git (normalización automática de URL)
Soporte para subdirectorio de monorepo + archivo único
Resolución recursiva de dependencias
craftdesk.json + lockfile para reproducibilidad
Sincronización multi-agente: Claude Code, Cursor, Windsurf, Continue.dev
Verificación de checksum para integridad
Skills embebidas (locales al repositorio) soportadas
Colecciones para crafts agrupados

Demo en vivo

Cómo se ve en la práctica

craftdesk-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": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_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": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_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": {
    "craftdesk-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mensfeld/craftdesk",
        "~/.claude/skills/craftdesk"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add craftdesk-skill -- git clone https://github.com/mensfeld/craftdesk ~/.claude/skills/craftdesk

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

Casos de uso

Usos del mundo real: craftdesk

Gestiona un conjunto de skills estándar de equipo entre múltiples desarrolladores

👤 Equipos de plataforma estandarizando herramientas de IA ⏱ ~30 min intermediate

Cuándo usarlo: Los miembros del equipo eligen skills diferentes; quieres que todos usen el mismo conjunto.

Requisitos previos

CraftDesk instalado — git clone https://github.com/mensfeld/craftdesk ~/.claude/skills/craftdesk o npm install -g craftdesk (por proyecto)

Flujo

Inicializa un manifiesto de proyecto

craftdesk init — configura craftdesk.json para este repositorio.✓ Copiado

→ craftdesk.json creado
Añade skills

craftdesk add planning-with-files agent-skill-tdd swing-skills — fija versiones.✓ Copiado

→ Manifiesto actualizado, lockfile escrito
El equipo instala

El compañero ejecuta craftdesk install en el clon.✓ Copiado

→ Los mismos skills y versiones llegan a su máquina

Resultado: Un entorno de skills reproducible como un package.json para IA.

Errores comunes

Confirmar secretos desde skills embebidas — Las skills embebidas no deberían llevar credenciales — mantén esas en env

Combinar con: filesystem · github

Sincroniza skills entre Claude Code, Cursor y Windsurf

👤 Desarrolladores usando múltiples agentes ⏱ ~10 min beginner

Cuándo usarlo: Instalas un skill en Claude Code y lo quieres en Cursor también.

Flujo

Sincroniza

craftdesk sync — hace que todos los crafts instalados estén disponibles en todos mis agentes.✓ Copiado

→ Rutas de instalación por agente completadas
Verifica

craftdesk verify — ¿alguna discrepancia?✓ Copiado

→ Verde en todos los agentes

Resultado: Herramientas consistentes sin importar qué agente abras.

Publica un craft interno en un registro privado

👤 Equipos con skills propietarios ⏱ ~20 min intermediate

Cuándo usarlo: Construiste un skill para procesos internos y quieres que sea instalable con craftdesk add.

Flujo

Publica

craftdesk publish — sube este craft a nuestro registro.✓ Copiado

→ Publicado con versión

Resultado: Una biblioteca interna de crafts versionada como cualquier dependencia de código.

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

craftdesk-skill + github

Instala crafts directamente desde URLs de GitHub

craftdesk add https://github.com/org/skill✓ Copiado

craftdesk-skill + filesystem

Las skills embebidas bajo ./skills/ se detectan automáticamente

Crea un skill embebido en ./skills/custom-review y ejecuta craftdesk sync.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
craftdesk init	(ninguno)	Inicio de un nuevo proyecto
craftdesk install	(lee craftdesk.json + lockfile)	Después de clonar / hacer pull
craftdesk add	nombre o URL	Añade una dependencia
craftdesk list	(ninguno)	Verificación de inventario
craftdesk sync	(ninguno)	Después de instalar o actualizar
craftdesk publish	ruta del craft	Lanzamiento interno
craftdesk verify	(ninguno)	Verificación de cordura

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno
Tokens por llamada: Mínimo — CraftDesk es impulsado por CLI
Monetario: Gratis
Consejo: Usa el lockfile — evita re-resolver en cada instalación

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Tokens de registro en env si publicas privadamente

Salida de datos: Solo a hosts de git desde los que instalas + cualquier registro configurado

CraftDesk instala código arbitrario desde URLs — empareja con repo-forensics antes de añadir crafts desconocidos.

Resolución de problemas

Errores comunes y soluciones

La instalación falla con discrepancia de checksum

El upstream cambió; fija a un sha de commit o reconcilia el lockfile deliberadamente

craftdesk sync se pierde un agente

Confirma que la ruta del agente existe y es escribible; ve craftdesk config

Alternativas

craftdesk vs otros

Alternativa	Cuándo usarla	Contrapartida
Clon de git manual en el directorio de skills	Máquina única, sin equipo	Sin fijación, sin sincronización
gsd-skill-creator	Quieres que los skills se escriban para ti, no gestionados	Problema diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills