skills

Skills for Real Engineers es un repositorio de Matt Pocock que contiene habilidades de agente utilizadas para la ingeniería de software cotidiana con agentes de codificación con IA. Se comparte desde el directorio .agents del autor y está diseñado para ser pequeño, adaptable, componible y agnóstico del modelo. El autor distingue estas habilidades de enfoques más amplios que controlan el proceso, como GSD, BMAD y Spec-Kit, argumentando que esos enfoques quitan control al desarrollador; estas habilidades, en cambio, buscan integrarse en los flujos de trabajo existentes. La instalación ofrece dos vías: un plugin de Claude Code instala el conjunto completo como un paquete gestionado y de solo lectura que se actualiza automáticamente, mientras que el instalador skills.sh copia archivos de habilidades editables en un proyecto para que los usuarios puedan modificarlos. Tras la instalación, se ejecuta una vez por repositorio una habilidad de configuración (setup-matt-pocock-skills) para configurar el gestor de incidencias (GitHub, Linear o archivos locales), las etiquetas de triaje y la ubicación de la documentación. La motivación declarada del repositorio es corregir modos de fallo comunes en los agentes de codificación: - Desalineación entre lo que quiere el usuario y lo que construye el agente, abordada mediante sesiones de interrogatorio que cuestionan el plan antes de comenzar el trabajo (grill-me, grill-with-docs). - Salida excesivamente verbosa del agente, abordada mediante la construcción de un lenguaje de dominio compartido documentado en CONTEXT.md y ADR, para que los agentes razonen y se comuniquen de forma más concisa. - Código que no funciona, abordado mediante bucles de retroalimentación: tipos estáticos, acceso al navegador y pruebas automatizadas, incluida una habilidad de TDD de rojo-verde-refactorización y un bucle de diagnóstico de errores por fases. - Deterioro de la arquitectura, abordado mediante habilidades centradas en el diseño que fomentan módulos profundos y evaluaciones periódicas de la arquitectura del código. Las habilidades se organizan en dos categorías principales: Las habilidades de ingeniería incluyen comandos invocados por el usuario, como ask-matt (un enrutador sobre habilidades), grill-with-docs, triage, improve-codebase-architecture, to-spec, to-tickets, implement y wayfinder. Las habilidades de ingeniería invocadas por el modelo incluyen prototype, diagnosing-bugs, research, tdd, domain-modeling, codebase-design, code-review, resolving-merge-conflicts y wizard. Las habilidades invocadas por el modelo pueden ser llamadas automáticamente por el agente cuando corresponda; las habilidades invocadas por el usuario orquestan flujos de trabajo y pueden invocar a las invocadas por el modelo. Las habilidades de productividad, utilizables más allá de la codificación, incluyen comandos invocados por el usuario como grill-me, handoff, teach, to-questionnaire y wait-what, además de la primitiva reutilizable de entrevista grilling y writing-for-agents para producir documentación legible por agentes, como AGENTS.md y CLAUDE.md. El autor ofrece un boletín para mantenerse informado sobre cambios en las habilidades. El repositorio también documenta decisiones de diseño, incluida una sobre su distribución como plugin de Claude Code, en un directorio ADR. En conjunto, es una biblioteca práctica de prácticas de ingeniería repetibles codificadas como comandos de barra y habilidades invocables por agentes, dirigida a desarrolladores que desean más control sobre cómo los agentes de IA escriben software.