claude-code-skill-factory MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

5 constructores interactivos que cubren cada forma de extensión de Claude Code
Comando slash /build — asistente de principio a fin para skills, agentes, prompts, hooks
/validate-output — valida frontmatter de SKILL.md, estructura de archivos, empaqueta como ZIP
9 skills listos para producción incluidos de fábrica
/sync-agents-md genera AGENTS.md para compatibilidad entre herramientas (Cursor, Codex)
Plantillas basadas en 69+ marcos de prompts preestablecidos

Demo en vivo

Cómo se ve en la práctica

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

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

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

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add claude-code-skill-factory-skill -- git clone https://github.com/alirezarezvani/claude-code-skill-factory ~/.claude/skills/claude-code-skill-factory

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

Casos de uso

Usos del mundo real: claude-code-skill-factory

Cómo construir y empaquetar un nuevo Skill de Claude en 10 minutos

👤 Desarrolladores que desean distribuir un skill sin escribir manualmente el boilerplate de SKILL.md ⏱ ~15 min beginner

Cuándo usarlo: Tienes un flujo de trabajo repetible en mente y deseas que Claude lo empaquete como un skill instalable.

Requisitos previos

Skill Factory instalado — git clone https://github.com/alirezarezvani/claude-code-skill-factory ~/.claude/skills/claude-code-skill-factory

Flujo

Ejecuta /build

/build — Quiero un skill que audite una app Next.js para problemas de Core Web Vitals y produzca un reporte estilo Lighthouse.✓ Copiado

→ Factory hace preguntas aclaratorias: triggers, categorías de herramientas, formato de salida
Responde las preguntas de scaffolding

Activa en 'audit CWV' o proyecto Next.js detectado. Genera reporte markdown con capturas.✓ Copiado

→ Borrador de SKILL.md con frontmatter, ejemplos de uso, archivos de referencia
Valida y empaqueta

/validate-output✓ Copiado

→ Validaciones correctas en frontmatter, estructura de directorios, completitud de ejemplos; ZIP generado
Instala localmente

/install-skill ./out/cwv-audit.zip✓ Copiado

→ Skill aparece en ~/.claude/skills y es descubierto por Claude Code

Resultado: Un skill funcional e instalado listo para activarse en el próximo prompt coincidente.

Errores comunes

Skill se activa demasiado agresivamente en prompts no relacionados — Ajusta la 'description' en frontmatter — Claude la usa para decidir cuándo cargar el skill
El ejemplo en SKILL.md se aleja del comportamiento real — /validate-output vuelve a ejecutar el ejemplo e indica discrepancias

Combinar con: skills-skill-2

Conecta un hook pre-commit mediante la Hooks Guide

👤 Equipos que desean automatizar el comportamiento de Claude Code en eventos específicos ⏱ ~10 min intermediate

Cuándo usarlo: Deseas que algo se ejecute automáticamente en envío de prompt, uso de herramienta, o cierre de sesión — no un skill que Claude deba elegir cargar.

Flujo

Inicia la Hooks Guide

/build hook — ejecuta gitleaks en cada llamada a Write antes de que Claude guarde secretos✓ Copiado

→ La Guide pregunta qué evento: PreToolUse/PostToolUse/Stop
Define matcher y comando

Coincide con llamadas a Write, canaliza contenido de archivo a través de gitleaks detect, bloquea si encuentra algo.✓ Copiado

→ Borrador del bloque de hook settings.json con matcher + comando
Instala en configuración del usuario

/install-hook — alcance de usuario✓ Copiado

→ ~/.claude/settings.json actualizado; siguiente llamada a herramienta está limitada

Resultado: Un hook que bloquea escrituras que filtraron secretos antes de que ocurran.

Errores comunes

El hook se ejecuta muy lentamente y detiene cada llamada a herramienta — Muévelo a PostToolUse si la verificación no necesita bloquear

Combinar con: claude-code-owasp-skill

Crea un paquete de prompts reutilizable usando marcos respaldados por investigación

👤 Ingenieros de prompts que construyen prompts internos consistentes para un equipo ⏱ ~15 min beginner

Cuándo usarlo: Deseas que cada compañero de equipo obtenga prompts estructurados CO-STAR / RISEN sin memorizar los marcos.

Flujo

Invoca la Prompts Guide

/build prompts — 5 presets para respuestas de soporte al cliente, estructurados CO-STAR✓ Copiado

→ La Guide lista marcos disponibles y pregunta qué sesgo de tono/rol
Revisa y exporta

Exporta como un skill prompt-pack para que todo el equipo pueda instalar mediante git clone.✓ Copiado

→ Bundle de skill con SKILL.md, directorio prompts/, README

Resultado: Paquete de prompts compartido por el equipo instalable mediante un git clone.

Combinar con: prompt-architect-skill

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

claude-code-skill-factory-skill + prompt-architect-skill

Prompt Architect ajusta prompts individuales; Skill Factory empaqueta conjuntos de ellos en un skill compartible

Usa prompt-architect para ajustar estos 5 prompts, luego /build prompts y exporta como un paquete de skill.✓ Copiado

claude-code-skill-factory-skill + skills-skill-2

Usa la colección de skills de Posit como plantillas de referencia cuando construyas la tuya

Muéstrame la estructura del skill Posit R-analysis, luego /build un skill Python-analysis paralelo basado en él.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
/build	target: 'skill'\|'agent'\|'prompt'\|'hook', description: str	Punto de entrada de nivel superior para crear cualquier nueva extensión	sesión Claude interactiva
/validate-output	path: str	Antes de distribuir un skill	0
/install-skill	zip_or_path: str, scope?: 'user'\|'project'	Después de que validate pase	0
/install-hook	hook_definition	Después de que Hooks Guide produzca un borrador	0
/sync-agents-md	skill_path: str	Distribuir en Cursor/Codex	0
/factory-status	-	Solución de problemas de constructores faltantes	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno — se ejecuta completamente dentro de Claude Code
Tokens por llamada: 5k-20k tokens para una sesión de build completa
Monetario: Gratuito. Consume tu suscripción a Claude.
Consejo: Mantén las sesiones del constructor enfocadas — responde decisivamente para evitar expandir la conversación en rehacer trabajo.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales. Skill Factory escribe solo en ~/.claude/skills y ~/.claude/settings.json.

Salida de datos: Sin llamadas salientes más allá de Claude Code.

/install-hook modifica settings.json — revisa el hook generado antes de instalar en alcance de usuario.

Resolución de problemas

Errores comunes y soluciones

/build no reconocido

Skill Factory no está cargado. Confirma la ruta del clon y que SKILL.md esté en la raíz del repositorio, no en una subcarpeta.

Verificar: ls ~/.claude/skills/claude-code-skill-factory/SKILL.md

ZIP generado falla en /install-skill

Generalmente un error tipográfico en frontmatter de SKILL.md. Ejecuta /validate-output primero; muestra el campo exacto que falta.

Hook no produce salida después de instalar

Matcher es demasiado estrecho. /factory-status muestra qué eventos se están activando; amplía el matcher en settings.json.

Verificar: cat ~/.claude/settings.json | jq .hooks

Alternativas

claude-code-skill-factory vs otros

Alternativa	Cuándo usarla	Contrapartida
skills-skill-2 (skills de Posit)	Solo deseas skills hechos, no una fábrica para construir los tuyos	Sin scaffolding, sin constructor de hooks
Escribir SKILL.md manualmente	Ya has construido varios skills y conoces la forma	Más control, más lento, sin validación

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills