📦 Sobre el repositorio

Fork organizado del conjunto de skills publicado por Matt Pocock, empaquetado como plugin de Claude Code.

Entender la procedencia ayuda a confiar en las convenciones y a seguir upstream.

Fork seleccionado, upstream, plugin de Claude Code, autoría.

Cada skill es pequeña, encadenable y adaptable: lo opuesto a los frameworks monolíticos.

Estos 3 valores explican por qué las skills superan a los agentes gigantes en proyectos reales.

Responsabilidad única, composición, fácil de bifurcar.

engineering = día a día de código; productivity = workflow no relacionado con código; misc = se mantiene, pero se usa poco.

Saber en qué categoría buscar evita perder tiempo explorando el repo.

Categorización, descubrimiento e intención de uso.

Comparación directa: GSD/BMAD/Spec-Kit son frameworks cerrados; mp-skill es una colección suelta de skills.

Elegir la herramienta adecuada para cada problema — no todo es una skill.

Framework vs. toolkit, lock-in, granularidad.

Desarrolladores full stack con mucho TypeScript, creadores independientes, equipos pequeños que usan Claude Code/Codex todos los días.

Conocer al público objetivo ayuda a calibrar las expectativas y contribuir bien.

Persona, casos de uso reales, comunidad.

Licencia permisiva + flujo de contribución mediante PR: apertura a nuevas skills y mejoras.

Saber qué puedes redistribuir, adaptar y enviar de vuelta sin fricción.

Licencia, PR, CODEOWNERS, atribución.

Bucket con skills de código: grill-me, tdd, diagnose, improve-codebase-architecture, etc.

Es donde ocurre el 80% del uso diario — vale la pena conocer cada una.

Habilidades centrales, gateway, comandos slash.

Bucket con skills de proceso: handoff, statusline, audit, planning — fuera del editor.

Las skills de proceso son las que más ahorran tiempo y contexto entre sesiones.

Workflow, handoff, sesión.

Skills que se mantienen, pero se usan esporádicamente: no merecen destacarse ni eliminarse.

Encontrar la skill adecuada en el momento oportuno. Conviene revisar misc trimestralmente.

Cola larga, mantenimiento mínimo.

personal = configuración del dueño; in-progress = borradores; deprecated = retirados — ninguno aparece en el README/plugin.json.

Entender por qué las skills desaparecen del índice evita confusiones al contribuir.

Ciclo de vida, borrador, promoción y obsolescencia.

docs/ guarda referencias; scripts/ contiene utilidades; CLAUDE.md establece reglas para organizar el propio repo.

Si no entiendes CLAUDE.md, romperás las convenciones al agregar una skill nueva.

Reglas de proyecto, automatización y documentación.

plugin.json registra las skills publicadas; README enumera cada skill con un enlace a SKILL.md.

Toda skill nueva debe incluirse en ambos; de lo contrario, queda invisible en el plugin.

Manifiesto, índice, gates de publicación.

Tener Claude Code o Codex instalado, con un plan compatible y una shell funcional.

Sin el runtime correcto, las skills ni siquiera aparecen: depurar esto después es frustrante.

Runtime, plan, shell y host de plugins.

Comando único que descarga y registra el plugin en Claude Code/Codex.

Es el camino oficial — otras formas de instalar se rompen al actualizar.

npx, registry, marketplace, plugin.

El asistente interactivo te permite elegir qué skills habilitar; se recomienda empezar por las de ingeniería.

Demasiadas skills para el agente = ruido. Una selección inicial vale oro.

Curaduría, alcance, activación selectiva.

Slash command que crea un CONTEXT.md inicial, configura los valores predeterminados y valida los triggers.

Evita gran parte de la configuración manual y garantiza que las skills se activen con los disparadores correctos.

Bootstrap, valores predeterminados, triggers.

GitHub Issues de mp-skill con labels (bug, skill-request, docs): cola pública de solicitudes.

Usar la etiqueta correcta acelera la respuesta y evita issues duplicadas.

Triage, etiquetas, prioridad, comunidad.

Lista de verificación: listar las skills en el agente, ejecutar /grill-me en un repo de prueba y revisar los logs.

Validar temprano evita descubrir que la instalación falló justo al momento de usarla.

Smoke test, dry-run, logs.