Skills de ingeniería de Matt Pocock

Skills For Real Engineers es la colección de instrucciones de Matt Pocock para trabajar con agentes en tareas de ingeniería. Esta ficha trata de su conjunto de ingeniería: preparación del proyecto, definición del problema, especificaciones, tickets, pruebas, revisión y diseño del código. Las skills se presentan como piezas pequeñas que se pueden adaptar y combinar; el repositorio también mantiene una categoría de productividad con otro alcance.

El formato de distribución importa tanto como el catálogo. Se puede instalar un plugin que gestiona sus actualizaciones o copiar archivos editables mediante skills.sh y mantenerlos manualmente. El README indica elegir una vía por agente, porque usar ambas duplica las skills. La autoría corresponde a Matt Pocock; el catálogo donde se descubre el recurso actúa como fuente secundaria y no como creador.

El conjunto aborda varios problemas del trabajo con agentes: falta de acuerdo sobre lo que se quiere construir, vocabulario inconsistente, cambios sin una comprobación adecuada y código que se vuelve difícil de modificar. Las piezas de entrevista y documentación buscan aclarar el objetivo antes de implementar. Las de especificación y tickets organizan lo acordado. Las de pruebas y revisión aportan disciplinas para comprobar el cambio.

grill-with-docs incorpora un modelo de dominio compartido, precisa términos y actualiza el glosario y los registros de decisiones. Esa documentación permite conservar el significado de palabras que, sin contexto, el agente tendría que volver a interpretar. to-spec utiliza una conversación ya mantenida para sintetizar una especificación; no representa una entrevista nueva. to-tickets añade una división del trabajo con dependencias explícitas. Son responsabilidades diferentes dentro de un mismo recorrido.

El repositorio se distribuye con MIT License, comprobada el 2026-10-25. El perfil enlaza la identidad oficial y conserva su comprobación técnica. Al valorar una skill concreta conviene leer su archivo además del resumen del catálogo: la descripción general de una disciplina puede ser más amplia que las reglas que aplica la versión concreta del archivo.

Un ejemplo está en tdd. El archivo consultado define el ciclo como prueba que falla y código mínimo que la supera, y sitúa la refactorización en la etapa de revisión. Esta precisión afecta al orden del trabajo. La colección no debe interpretarse como una plantilla rígida que sustituye las decisiones del proyecto: sus piezas se presentan como adaptables y combinables.

Ejemplo de KIRELEN (no oficial): un equipo necesita cambiar una regla de negocio y todavía usa términos ambiguos. Primero puede aclarar el significado de esos términos mediante grill-with-docs y recoger las decisiones en el glosario y los ADRs. Una vez existe una conversación suficientemente concreta, to-spec sintetiza lo acordado y to-tickets lo divide en trabajo con dependencias.

Si el equipo utiliza tdd para implementar ese cambio, la skill pide acordar las interfaces públicas que se probarán. Cada ciclo empieza con una prueba que falla y continúa con la implementación mínima necesaria. El objetivo es observar comportamiento desde una interfaz estable, de modo que los cambios internos no obliguen por sí solos a reescribir todas las pruebas. Este ejemplo explica el encaje de las piezas; no representa una implementación ni resultados medidos de un proyecto.