Skills For Real Engineers - Matt Pocock

Colección de skills de agentes de Matt Pocock, una caja de herramientas para ingeniería real y no para vibe coding

Este repositorio es un proyecto publicado por Matt Pocock, muy conocido como educador de TypeScript, donde reúne los skills de agentes para Claude Code que usa a diario, es decir, comandos slash y convenciones de comportamiento. Su lema es "Skills For Real Engineers", y el autor considera que frameworks como GSD, BMAD y Spec-Kit, que cargan con todo el proceso de punta a punta, le quitan el control al desarrollador y dificultan rastrear los defectos cuando algo falla. Como alternativa, propone un enfoque basado en herramientas pequeñas, reemplazables y combinables con cualquier modelo. De hecho, al abrir el codebase se ve que los skills están divididos dentro de skills/ en buckets como engineering, productivity, misc, personal, in-progress y deprecated, y cada skill se administra como una unidad independiente con su propio SKILL.md.

• La simplicidad de la ruta de instalación: se instala en una sola línea con npx skills@latest add mattpocock/skills, y con /setup-matt-pocock-skills se define de una vez el tipo de issue tracker, el vocabulario de labels para triage y la ubicación donde se guardará la documentación. Solo hay que ejecutarlo una vez por repositorio, y luego los demás skills comparten esa configuración.

• La intención de diseño que organiza en cuatro modos de falla de los agentes: el primero es un problema de alineación, “no logra construir lo que uno quiere”, y grill-me y grill-with-docs fuerzan una sesión de entrevista que sigue preguntando por la intención hasta el final. El segundo es el problema del “agente excesivamente verboso”, para lo cual se crea CONTEXT.md, una especie de diccionario de términos del dominio que reduce tanto el desperdicio de tokens como los problemas de consistencia en los nombres. El tercero es el problema de “el código no funciona”, donde tdd se encarga del ciclo red-green-refactor y diagnose del ciclo de depuración desde la reproducción hasta las pruebas de regresión. El cuarto es el del “código convertido en una bola de lodo”, y ahí to-prd, zoom-out e improve-codebase-architecture se ocupan de recuperar los límites modulares y la visión del sistema.

• La diferencia en cómo maneja el lenguaje compartido: va un paso más allá de la simple asistencia de programación y pone mucho peso en hacer coincidir explícitamente el vocabulario entre el agente y las personas. Como ejemplo, el CONTEXT.md mostrado para course-video-manager comprime en una sola expresión, “materialization cascade”, “el problema del momento en que una lección dentro de una sección dentro de un curso obtiene un lugar en el sistema de archivos”, de manera que al repetir la misma conversación se reduzcan al mismo tiempo los tokens y el costo cognitivo.

• La practicidad de los skills secundarios: para el flujo de trabajo diario se incluyen caveman (un modo de respuesta comprimida que apunta a ahorrar alrededor del 75 por ciento de los tokens) y write-a-skill (un meta skill para crear skills). Además, el paquete de herramientas auxiliares incluye git-guardrails-claude-code (configuración de hooks para bloquear por adelantado comandos peligrosos de git) y setup-pre-commit (configuración de pre-commit basada en Husky + lint-staged), por lo que también aborda áreas fuera de la escritura de código mediante pequeñas herramientas separadas.

• Las reglas operativas del propio repositorio: los skills que entran en engineering, productivity y misc deben registrarse obligatoriamente tanto en el README de nivel superior como en .claude-plugin/plugin.json, mientras que en personal, in-progress y deprecated ese registro está prohibido, forzando así el alcance público a nivel de código. El hecho de que los documentos ADR existan en un directorio separado y que los scripts de shell para enlazar skills estén apartados en scripts/ también se lee como una extensión de esa misma disciplina.

En conjunto, este proyecto toma distancia de la automatización integrada del tipo “el agente se encarga solo de todo” y se parece más a una adaptación de principios clásicos de ingeniería —como Pragmatic Programmer, Domain-Driven Design, Extreme Programming y A Philosophy of Software Design— descompuestos en pequeños comandos slash reemplazables. Para quien espere una herramienta vistosa de automatización de workflows puede parecer algo sobrio, pero tiene un carácter más cercano al trabajo real al intentar llevar al terreno cotidiano, incluso en la era de los agentes, fundamentos como la alineación, el lenguaje compartido, los ciclos de retroalimentación y el diseño modular.