Guía completa de Skills For Real Engineers: la biblioteca de skills de IA de Matt Pocock

Qué es Skills For Real Engineers

Respuesta en una frase: Skills For Real Engineers (nombre del repositorio: Matt Pocock Skills) es una biblioteca de skills para agentes de IA creada por Matt Pocock a partir de su práctica diaria con el directorio .claude.

Su posicionamiento es claro: no es un juguete para hacer vibe coding, sino un kit diario para hacer ingeniería de verdad. Según el propio autor, creó estos skills para corregir los modos de fallo más habituales que encontraba una y otra vez en agentes de codificación como Claude Code o Codex.

Diferencias con GSD y BMAD

GSD, BMAD y Spec-Kit intentan hacerse cargo del proceso. Al hacerlo, también te quitan el control: cuando el proceso falla, es difícil localizar el problema. Skills For Real Engineers va en la dirección contraria:

• Pequeño y bien hecho: cada skill funciona de forma independiente, sin un framework monolítico.
• Componible: elige, recorta y adapta lo que necesites para tu repositorio.
• Hackeable: los skills son archivos ordinarios de tu repositorio; si algo no te convence, lo cambias.
• Independiente del modelo: no está atado a un modelo concreto; funciona con Claude, Codex, Cursor, etc.
• Ingeniería de base: se apoya en principios clásicos de ingeniería —como los de The Pragmatic Programmer y Domain-Driven Design—, no en trucos de prompts.

Posicionamiento del producto

Está pensado para desarrolladores con hábitos de ingeniería reales: usa retroalimentación auténtica —tipado estático, pruebas automatizadas, refactor rojo-verde— para mantener al agente bajo control y evitar que vuele a ciegas. La biblioteca no ofrece un servicio alojado ni decide la arquitectura por ti: solo aporta un conjunto reutilizable de interfaces de conversación y flujo de trabajo.

Funciones principales

Los skills se entregan al agente como comandos de barra (/) y se agrupan en varias categorías.

Alineación de requisitos

• /grill-me: mediante una sesión de preguntas intensas, alinea por completo los requisitos y las ramas de decisión antes de escribir código; también sirve para escenarios sin código.
• /grill-with-docs: sobre la base del grilling, construye de forma conjunta el lenguaje compartido del proyecto y los registros de decisiones de arquitectura (ADR).
• /zoom-out: pide al agente que salga del código local y explique desde la perspectiva global del sistema.

Desarrollo y validación

• /tdd: impulsa al agente a ejecutar el ciclo rojo-verde-refactor y a construir funciones o corregir defectos por rebanadas verticales (vertical slices).
• /diagnose: bucle de diagnóstico estructurado: reproducir → minimizar → hipótesis → instrumentar → corregir → prueba de regresión.
• /prototype: crea rápidamente prototipos de terminal funcionales o varias variantes de UI para validar un diseño.

Tareas y planificación

• /triage: clasifica y asigna issues mediante una máquina de estados, con soporte para un vocabulario de etiquetas personalizado.
• /to-prd: sintetiza automáticamente el contexto de la conversación actual en un PRD y lo crea como issue de GitHub.
• /to-issues: divide un plan o un PRD en tareas de rebanada vertical que pueden asumirse de forma independiente.

Arquitectura y colaboración

• /improve-codebase-architecture: identifica oportunidades para profundizar en los módulos con base en CONTEXT.md y los ADR, y combate la «bola de barro» arquitectónica (big ball of mud).
• /caveman: modo de comunicación ultracómico que reduce el consumo de tokens en torno a un 75 % sin perder precisión técnica.
• /handoff: comprime la sesión actual en un documento de traspaso para que otro agente pueda continuar sin fricción.
• /teach: convierte el directorio actual en un espacio de enseñanza con estado y explica nuevas skills o conceptos a lo largo de varias sesiones.
• /write-a-skill: crea nuevos skills con una estructura definida, con divulgación progresiva y empaquetado de recursos.

El mecanismo del lenguaje compartido

Establecer la terminología del proyecto mediante CONTEXT.md es el recurso que el autor valora por encima de todos en esta biblioteca. Lo que observó es que el agente suele ser lanzado directamente al proyecto y va adivinando la jerga sobre la marcha: algo que se podía decir con una palabra termina expresándose con veinte.

Ejemplo: cambiar «hay un problema cuando una lección dentro de una sección del curso se convierte en 'real' (es decir, se le asigna un lugar en el sistema de archivos)» por «hay un problema con la cascada de materialización» ahorra muchísima explicación en una frase, y esa concisión se acumula sesión tras sesión.

El lenguaje compartido aporta además: nombres coherentes en variables, funciones y archivos; una base de código más fácil de navegar para el agente; y menos tokens de razonamiento, porque dispone de un lenguaje más conciso.

Cómo usar Skills For Real Engineers

Hay dos vías de entrada, que corresponden a dos filosofías distintas; solo debes elegir una.

Vía 1: el plugin de Claude Code

• Instala todo el conjunto como un paquete gestionado de solo lectura que se actualiza automáticamente cuando el autor publica una versión; es como suscribirse en lugar de hacer un fork.
• Ya está en el marketplace oficial de Claude Code: no hay que añadir ninguna fuente y las actualizaciones llegan solas.
• Un plugin nativo para Codex está en la hoja de ruta (ver .agents/adr/0002-ship-as-a-claude-code-plugin.md).

Vía 2: el instalador de skills

Ejecuta npx skills@latest add mattpocock/skills, elige el agente de destino y marca /setup-matt-pocock-skills. El instalador te deja elegir los skills que quieres y en qué agentes de codificación instalarlos; los skills se escriben en tu repositorio como archivos ordinarios que tú posees y puedes editar. Nada se actualiza por detrás: cuando quieras, trae los últimos cambios con npx skills update.

Aviso: instalar las dos vías a la vez deja cada skill duplicado.

Inicialización y ritmo diario

1. Ejecuta /setup-matt-pocock-skills una vez en el agente, una vez por repositorio. Te preguntará qué rastreador de issues usar (GitHub, Linear o archivos locales), qué etiquetas aplicas cuando haces triage (/triage depende de esas etiquetas) y dónde guardar los documentos que se generen.
2. Antes de cada cambio, alinea los requisitos con /grill-me o /grill-with-docs.
3. Durante el desarrollo, usa /tdd para garantizar la calidad.
4. Si encuentras un bug, usa /diagnose para iniciar un diagnóstico estructurado.
5. Para el mantenimiento de la arquitectura, ejecuta /improve-codebase-architecture con regularidad y evita que el código se degrade.

La instalación y configuración completas toman unos 30 segundos y admiten GitHub, Linear o archivos locales como rastreador de issues.

Casos de uso

• Alineación de requisitos y planificación: antes de arrancar un proyecto o cambiar una funcionalidad, usa /grill-me o /grill-with-docs para interrogar intensamente al agente y asegurar que ambas partes quedan totalmente alineadas en requisitos, ramas de decisión y terminología del dominio.
• Desarrollo guiado por pruebas: cuando necesites garantizar la calidad del código, usa /tdd para que el agente ejecute el ciclo rojo-verde-refactor y construya funcionalidad o corrija defectos por rebanadas verticales, de modo que cada cambio quede protegido por pruebas automatizadas.
• Diagnóstico de bugs complejos: ante regresiones de rendimiento o defectos lógicos difíciles de reproducir, usa /diagnose para completar el bucle diagnóstico: reproducir → minimizar → hipótesis → instrumentar → corregir → prueba de regresión.
• Gobernanza continua de la arquitectura: en bases de código grandes y de mantenimiento prolongado, ejecuta /improve-codebase-architecture con regularidad para identificar oportunidades de profundización de módulos con base en CONTEXT.md y los ADR, y evitar que el agente acelere la degradación del código.
• Colaboración entre sesiones: comprime la sesión con /handoff y reduce los tokens con /caveman; muy útil para tareas largas y para relevos entre varias personas y agentes.

Ventajas

• Ligero y componible: rechaza los frameworks pesados; cada skill funciona de forma independiente y se puede recortar y adaptar.
• Independiente del modelo: funciona con Claude, Codex, Cursor, etc.
• Ingeniería de base: se apoya en principios clásicos de ingeniería, no en trucos de prompts.
• Lenguaje compartido: CONTEXT.md reduce de forma notable el coste de comunicación y el consumo de tokens del agente.
• Bucle de retroalimentación real: tipado estático, pruebas automatizadas, refactor rojo-verde.
• Fácil de adaptar: en la vía de skills, los skills son archivos editables dentro de tu repositorio.

Limitaciones

• Es un conjunto de skills, no un gestor de procesos de extremo a extremo; los equipos sin disciplina de lenguaje compartido ni ADR tendrán que mantener CONTEXT.md y los registros de decisiones por su cuenta.
• El sistema de etiquetas de /triage depende de la configuración inicial; si se configura mal, la clasificación pierde eficacia.
• Las dos vías de instalación son excluyentes: mezclarlas duplica los skills.
• El plugin nativo para Codex sigue en la hoja de ruta; los usuarios de Codex utilizan por ahora la vía de instalación por archivos de skills.
• El alcance exacto del soporte, los detalles de los comandos y la cadencia de actualizaciones pueden cambiar.

Nota sobre precio y disponibilidad

La ficha de hechos de este artículo no incluye precios, tarifas de suscripción ni condiciones de licencia, por lo que no haremos suposiciones. Para confirmar si es de pago, su modelo de licencia, los canales de instalación disponibles y el estado de la última versión, consulta directamente la web oficial del producto, https://github.com/mattpocock/skills, y la página del marketplace oficial del agente que uses.

Preguntas frecuentes (FAQ)

¿Está atado a un modelo concreto?

No. Según la descripción oficial es independiente del modelo: funciona con Claude, Codex, Cursor, etc.

¿Se puede usar directamente tras instalarlo?

Necesita una inicialización. Ejecuta /setup-matt-pocock-skills una vez en el agente para configurar el rastreador de issues, las etiquetas de triage y el directorio de documentos; a partir de ahí, skills como /triage trabajarán según tus convenciones.

¿Qué elijo, el plugin o el instalador?

Si quieres seguir las actualizaciones del autor y aceptar un paquete gestionado de solo lectura, elige el plugin de Claude Code; si prefieres poseer y modificar los archivos y controlar tú cuándo se actualizan, usa npx skills@latest add mattpocock/skills. No instales los dos a la vez.

¿Entra en conflicto con GSD o BMAD?

La intención de diseño del autor es ofrecer una alternativa: GSD, BMAD y Spec-Kit ayudan haciéndose cargo del proceso, pero eso te quita control y hace difícil resolver los problemas que aparecen dentro del proceso; esta biblioteca apuesta por skills pequeñas, componibles y hackeables. Mezclarlos o no depende de la disciplina de tu equipo.

¿Qué skill merece la pena probar primero?

El autor cree que /grill-with-docs podría ser la técnica más potente de todo el repositorio: es una sesión de preguntas intensas que además te ayuda a construir un lenguaje compartido con la IA y a documentar en ADR las decisiones difíciles de explicar.

Alternativas

• GSD, BMAD, Spec-Kit: frameworks pesados que intentan hacerse cargo del proceso de desarrollo; dan menos control y hacen más difícil localizar los problemas del proceso.
• El Agent Skill de código abierto de 一泽 Eze: se centra en «pensar cómo navegar por internet».
• El framework de skills agentic y el plugin de metodología de desarrollo de software de código abierto de Jesse Vincent.
• Un Skill de diseño de IA de código abierto, diseñado específicamente para asistentes de codificación con IA.
• Enfoque general: mantener tu propio conjunto de archivos de skills en .claude o a nivel de proyecto, combinándolos según los hábitos del equipo.

Fuentes primarias

• Web oficial y repositorio del producto: https://github.com/mattpocock/skills

Si quieres seguir los cambios de estos skills y los nuevos que publique el autor, puedes unirte a su newsletter, a la que están suscritos unos 60.000 desarrolladores.