La postura del repositorio es deliberadamente pequeña y componible. No intenta reemplazar el proceso de ingeniería con un marco de trabajo de agentes gigante. Proporciona a los agentes mejores hábitos para las partes del trabajo de software que fallan habitualmente: ambigüedad, bucles de retroalimentación, lenguaje de dominio, deriva de la arquitectura, pruebas y calidad de las entregas.
Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
Nota editorial
Este artículo se basa en el repositorio de GitHub, README, archivos de habilidades, scripts de configuración, documentación, problemas y PRs actuales, listado de skills.sh, enlace al boletín y metadatos públicos de GitHub recopilados el 2 de junio de 2026. Se omiten los contadores de popularidad exactos porque cambian rápidamente.
1. skills en una frase
El repositorio `skills` de Matt Pocock es un conjunto de habilidades de flujo de trabajo de agentes de IA pequeñas y adaptables, con licencia MIT, para tareas reales de ingeniería de software como TDD, diagnóstico, aclaración de productos, documentación, mejora de la arquitectura, clasificación de problemas y entregas.
| Área | Detalle | Por qué importa |
|---|---|---|
| Repositorio | mattpocock/skills | https://github.com/mattpocock/skills |
| Lenguaje principal | Shell | Lenguaje principal de GitHub en el momento de la investigación. |
| Licencia | MIT | Revisa por separado las licencias empaquetadas o binarias cuando corresponda. |
| Creado | 3 de febrero de 2026 | No se encontraron lanzamientos en GitHub durante la investigación; la rama principal y los issues están activos. |
2. Por qué importa
El repositorio es importante porque muchos fallos de codificación de IA son fallos de proceso. El agente malinterpreta la solicitud, cambia demasiado a la vez, carece de retroalimentación, ignora el lenguaje de dominio o produce código difícil de mantener.
En lugar de una metodología enorme, estas habilidades son herramientas específicas. Puedes ejecutar `/grill-with-docs` antes de una funcionalidad, `/tdd` durante la implementación, `/diagnose` en un error, `/improve-codebase-architecture` después de que se acumule la entropía y `/handoff` cuando el contexto deba moverse.
La postura de ingeniería también es notable: el README rechaza la codificación vaga basada en sensaciones y enfatiza fundamentos como el lenguaje compartido, red-green-refactor, pasos pequeños, retroalimentación, módulos profundos y administración del diseño.
3. Arquitectura y modelo mental
El repositorio está organizado por categoría de habilidad: ingeniería, productividad, varios, personal, en progreso y obsoleto. Una pequeña habilidad de configuración registra la configuración por repositorio, como el rastreador de problemas, las etiquetas de clasificación y la ubicación de la documentación, para que otras habilidades puedan operar de manera consistente.
| Área | Detalle | Por qué importa |
|---|---|---|
| Instalador | `npx skills@latest add mattpocock/skills` | Ruta de configuración principal del README a través de skills.sh. |
| Configurar skill | `setup-matt-pocock-skills` | Captura las ubicaciones del gestor de incidencias, etiquetas y documentación utilizadas por otras skills. |
| Planificación | `grill-with-docs`, `grill-me`, `to-prd`, `to-issues` | Clarifica la intención, los términos del dominio, las decisiones, los PRD y los fragmentos de incidencias. |
| Implementación | `tdd`, `diagnose`, `prototype` | Mejora los bucles de retroalimentación, la disciplina de depuración y el diseño exploratorio. |
| Arquitectura | `improve-codebase-architecture`, `zoom-out` | Encuentra presión de diseño, profundiza oportunidades y un contexto de código más amplio. |
| Operaciones | `triage`, `handoff`, `git-guardrails-claude-code`, `setup-pre-commit` | Soporta el estado de los problemas, la transferencia de contexto y flujos de trabajo de repositorio más seguros. |
| Documentación | Formatos `CONTEXT.md`, `docs/adr/`, `grill-with-docs` | El lenguaje compartido y los registros de decisiones de arquitectura son de primera clase. |
| Scripts | `scripts/link-skills.sh`, `scripts/list-skills.sh` | Ayudantes de shell locales para listar y vincular habilidades. |
4. Configuración end-to-end mínima
Los comandos de abajo se copiaron de la documentación del repositorio y se contrastaron con la instantánea de investigación actual. Úsalos como punto de partida y lee después el README enlazado antes de instalarlo en producción.
# Install through skills.sh
npx skills@latest add mattpocock/skills
# In your agent, select the skills you want.
# Include setup-matt-pocock-skills.
# Then run the setup skill once per repository:
/setup-matt-pocock-skillsUna primera tarea pequeña debe demostrar la integración antes de conectarla a datos críticos o workspaces grandes.
# Clarify a feature and update docs/ADRs
/grill-with-docs
# Build the change with a red-green-refactor loop
/tdd
# Diagnose a hard bug
/diagnose
# Break a plan into independently grabbable issues
/to-issues
# Hand off a session to another agent or future context
/handoff5. Análisis técnico profundo
5.1 La habilidad de configuración es la dependencia silenciosa
El README dice que selecciones `/setup-matt-pocock-skills` durante la instalación y lo ejecutes antes del resto del flujo de trabajo de ingeniería. Eso no es trabajo innecesario. Registra la elección del rastreador de problemas, las etiquetas de triaje y la ubicación de la documentación para que habilidades como `to-issues`, `triage` y `grill-with-docs` puedan comportarse de manera predecible.
Los problemas actuales incluso discuten los límites de la política de configuración. Esto nos dice que el repositorio se preocupa por la repetibilidad en lugar de dejar que cada habilidad redescubra las convenciones locales.
5.2 Grilling es una herramienta de definición de requisitos
`grill-me` y `grill-with-docs` se basan en una observación simple: los usuarios a menudo no saben exactamente lo que quieren hasta que se les cuestiona. La habilidad hace que el agente haga preguntas concretas antes de escribir código.
`grill-with-docs` extiende eso a un lenguaje compartido y ADRs. Eso es especialmente útil en productos reales porque los términos del dominio reducen las explicaciones verbosas y mejoran los nombres, las pruebas y los títulos de los problemas.
before coding:
ask hard questions
define domain terms
record decisions
narrow scope
then implement5.3 TDD y el diagnóstico crean bucles de retroalimentación
`/tdd` impulsa a los agentes hacia red-green-refactor y fragmentos verticales más pequeños. `/diagnose` impulsa reproducir, minimizar, hipotetizar, instrumentar, corregir y realizar pruebas de regresión.
Estas habilidades no hacen que un modelo sea más inteligente de forma aislada. Cambian el bucle alrededor del modelo para que obtenga mejor evidencia antes de editar y una mejor verificación después de editar.
5.4 El trabajo de arquitectura se enmarca como administración del diseño.
`improve-codebase-architecture` está dirigido a bases de código que se están volviendo difíciles de cambiar. El README lo vincula con ideas como módulos profundos, lenguaje de dominio e invertir en diseño todos los días.
Ese es el nivel correcto de ambición para una habilidad de agente: no 'reescribir la aplicación', sino inspeccionar la presión del diseño, aclarar las interfaces y producir oportunidades concretas de profundización.
5.5 El repositorio está diseñado intencionalmente para no ser un monolito.
Las habilidades son lo suficientemente pequeñas como para adaptarse. Eso importa porque los equipos tienen diferentes rastreadores de problemas, convenciones de documentación, herramientas de prueba, lenguaje de dominio y tolerancia a la autonomía del agente.
La superficie actual de PR y problemas muestra que el límite aún está evolucionando: dividir comandos frente a habilidades, mejores salidas de `/teach`, documentación fuera de los árboles de trabajo, comportamiento de descomposición de problemas y ajuste de la frecuencia de salida.
6. Patrones reales: incorrecto vs correcto
| Incorrecto | Correcto | Razón |
|---|---|---|
| Instala cada habilidad y espera que el agente conozca tu repositorio. | Ejecuta `/setup-matt-pocock-skills` y configura el rastreador de problemas, las etiquetas y las rutas de documentación. | Varias habilidades dependen de las convenciones locales. |
| Usa `/tdd` como etiqueta para escribir pruebas después del hecho. | Úsalo como red-green-refactor en pequeñas porciones verticales. | El valor reside en el ciclo de retroalimentación, no solo en los archivos de prueba. |
| Solicita mejoras de arquitectura sin documentación de dominio. | Construye un lenguaje compartido y ADRs primero cuando sea posible. | El análisis de arquitectura mejora cuando el agente entiende el lenguaje del producto. |
| Trátalos como un framework de agente completo. | Trátalos como herramientas de proceso componibles. | El repositorio es intencionalmente pequeño y adaptable. |
7. Errores comunes y problemas actuales
El issue tracker importa porque estos repos son jóvenes y cambian rápido. El artículo usa los issues como señales de riesgo, no como prueba de que el proyecto sea inutilizable.
| Área | Detalle | Por qué importa |
|---|---|---|
| Comandos vs habilidades | El PR #291 realiza el seguimiento de la división de habilidades en comandos frente a habilidades. | La semántica de empaquetado aún se está refinando. |
| Enseñar habilidad | El issue #296 solicita una mejor guía de diagramas de árbol y jerarquía. | Algunas habilidades en curso aún están evolucionando. |
| Ubicación de la documentación | El issue #294 solicita documentación fuera del árbol de trabajo para `grill-with-docs`. | Los flujos de trabajo de documentación entre árboles de trabajo requieren atención. |
| Descomposición de issues | El issue #292 indica que los issues padres siguen siendo seleccionables después de la descomposición. | Los flujos de trabajo `to-issues` pueden requerir limpieza manual. |
| Traspaso de arquitectura | El issue #290 solicita botones de traspaso en las páginas de arquitectura generadas. | Los informes generados se están convirtiendo en artefactos de flujo de trabajo. |
| Frecuencia de salida | El issue #284 cubrió la frecuencia de salida de `grill-with-docs`. | Las habilidades de entrevista requieren un ritmo que se ajuste al usuario. |
8. Notas de rendimiento, escalado y coste
Estas habilidades son principalmente texto y procesos, por lo que el costo de ejecución depende del agente y del tamaño del repositorio en lugar de una compilación local pesada. El mayor costo de tokens proviene de largas sesiones de interrogatorio, análisis de arquitectura, descomposición de issues y lecturas repetidas del código base.
La forma práctica de controlar el costo es elegir habilidades específicas. Use `/diagnose` para un bug, `/tdd` para una sección, `/to-issues` para un plan y `/handoff` cuando el contexto deba comprimirse.
El valor del repositorio es acumulativo: el lenguaje compartido, los ADRs, las secciones de issues y los traspasos reducen la ambigüedad futura, lo que puede ahorrar más tokens que los costos de la sesión inicial.
9. Para quién es
| Úsalo si | Evítalo si |
|---|---|
| Quieres flujos de trabajo de agentes que preserven la disciplina de ingeniería. | Quieres un marco autónomo que se encargue de todo el proceso. |
| Utilizas Claude Code, Codex o agentes compatibles que conocen las habilidades. | Tus herramientas no pueden cargar o adaptar flujos de trabajo `SKILL.md`. |
| Tu equipo valora el TDD, la disciplina de depuración, los ADR y la higiene de los issues. | Solo quieres una generación de código rápida de una sola vez. |
| Te sientes cómodo adaptando pequeñas habilidades a las convenciones de tu repositorio. | Necesitas un producto de gestión de proyectos totalmente alojado y con una opinión definida. |
10. Señal de la comunidad
La señal más fuerte de la comunidad es la audiencia existente de TypeScript y AI-engineering del mantenedor. El README dirige a las personas a través de skills.sh y una gran audiencia del boletín AI Hero, lo que le da al repositorio una distribución inmediata.
El rastreador de issues tiene una opinión productiva. Muchos issues son preguntas sobre políticas o flujos de trabajo, no solo errores: verificación de configuración, límites de preguntas, alcance del rastreador de issues, comportamiento de issues padres, rutas de documentación y empaquetado de comandos.
El enfoque del repositorio es refrescantemente realista: sostiene que los fundamentos importan más con los agentes, no menos.
11. El veredicto: ¿merece la pena usarlo?
Nuestra opinión
Utiliza las habilidades de Matt Pocock si buscas flujos de trabajo de agentes pequeños y componibles que hagan que la planificación, las pruebas, el diagnóstico, la arquitectura, la clasificación de problemas y las transferencias sean más disciplinadas. Evítalo si buscas un framework autónomo de un solo clic o un repositorio que oculte el proceso de ingeniería detrás de un solo comando.
12. El panorama general
Este repositorio representa una dirección madura para las herramientas de agentes: no agentes más grandes, sino mejores rituales en torno a ellos. La habilidad es el envoltorio de proceso que evita que un modelo convierta la ambigüedad en código demasiado pronto.
A medida que la programación con IA se vuelve más rápida, el cuello de botella se desplaza hacia el juicio, las restricciones, la retroalimentación y la mantenibilidad. Pequeñas habilidades como estas son una forma de codificar esos hábitos de ingeniería directamente en el flujo de trabajo del agente.
13. Preguntas frecuentes
P: ¿Cómo instalo las habilidades de Matt Pocock?
El README recomienda `npx skills@latest add mattpocock/skills`, luego seleccionar las habilidades que deseas y ejecutar `/setup-matt-pocock-skills`.
P: ¿Funcionan solo con Claude Code?
Están escritas como habilidades de agente y pueden adaptarse a agentes de programación compatibles que reconozcan habilidades. El comportamiento exacto de instalación depende de tu agente y del soporte de skills.sh.
P: ¿Con qué habilidad debería empezar?
Empieza con `/setup-matt-pocock-skills`, luego usa `/grill-with-docs` para nuevas funcionalidades, `/tdd` para la implementación y `/diagnose` para errores.
P: ¿Qué hace `/grill-with-docs`?
Hace preguntas detalladas sobre el cambio planificado, construye un lenguaje de dominio compartido y puede actualizar documentos de contexto y ADRs.
P: ¿Es `/tdd` solo generación de pruebas?
No. Es un flujo de trabajo red-green-refactor para implementar pequeñas secciones verticales con un ciclo de retroalimentación claro.
P: ¿Son estos un reemplazo para la gestión de proyectos?
No. Habilidades como `/to-issues`, `/triage` y `/to-prd` pueden integrarse con flujos de trabajo de incidencias, pero no reemplazan el juicio del equipo ni la propiedad del proceso.
14. Glosario
| Área | Detalle | Por qué importa |
|---|---|---|
| Habilidad | Un flujo de trabajo `SKILL.md` reutilizable para un agente. | El artefacto principal del repositorio. |
| Interrogatorio | Cuestionamiento estructurado antes de la implementación. | Utilizado para reducir la ambigüedad en los requisitos. |
| Lenguaje compartido | Vocabulario de dominio específico del proyecto. | Almacenado en documentos como `CONTEXT.md`. |
| ADR | Registro de decisiones de arquitectura. | Captura decisiones técnicas importantes. |
| Red-green-refactor | Escribir una prueba fallida, hacer que pase, mejorar el diseño. | Ciclo central de TDD. |
| Módulo profundo | Un módulo con una interfaz simple y una profundidad interna significativa. | Concepto de calidad de arquitectura. |
| Transferencia (Handoff) | Transferencia de contexto estructurado a una sesión o agente futuro. | Reduce la pérdida de contexto. |
15. Todas las fuentes y enlaces
Fuentes primarias
Problemas y PRs
- PR de comandos frente a habilidades
- Problema de guía de diagramas de enseñanza
- Problema de documentos fuera del worktree
- Problema de descomposición de issue padre
- Problema de transferencia de arquitectura
- Problema de flujo de trabajo de revisión
- Problema de ergonomía de instalación local
- PR de habilidad de configuración
Autor y comunidad
Enlaces internos
- Dominando las habilidades de Agent TARS
- Guía de habilidades de investigación académica
- Guía de mejores prácticas para Claude Code
16. Tabla de atribución de fuentes
| Área | Detalle | Por qué importa |
|---|---|---|
| README | Posicionamiento, flujo de instalación, declaraciones del problema central, mapa de habilidades. | Fuente primaria. |
| Archivos de habilidades | Comportamiento concreto para configuración, grilling, TDD, diagnóstico, arquitectura, problemas y entrega. | Fuente primaria. |
| Scripts y documentos. | Vinculación local, listado, documentos de contexto, formatos ADR. | Fuente de la estructura del repositorio. |
| Issues y PRs. | Empaquetado de comandos, ruta de documentos, teach, descomposición de issues y advertencias de configuración. | Señal de frescura. |
| skills.sh | Canal de distribución y marco de instalación. | Fuente oficial del ecosistema. |
Get the Ultimate Antigravity Cheat Sheet
Join 5,000+ developers and get our exclusive PDF guide to mastering Gemini 3 shortcuts and agent workflows.
Related Guides
Humanizer Skill Guide
blader/humanizer: 29 AI-writing patterns, voice calibration, and a two-pass audit, all in one Claude Code skill.
Guides & FeaturesMastering Agent Skills
The open standard for portable AI agent expertise.
Guides & FeaturesAntigravity Workflows Guide
Create automation recipes with Turbo Mode and AgentKit 2.0.
Guides & FeaturesHow to Change Antigravity Themes
Customize themes, dark mode, icons, and color schemes.
Guides & FeaturesHow to Change Language
Switch Antigravity to Spanish, German, Japanese, and more.
Guides & FeaturesAntigravity Security Guide
Known vulnerabilities, safe settings, and hardening steps.