/grill-me: la skill que convierte a tu agente de IA en un compañero que pregunta antes de romper cosas

Hay una escena que se repite cada vez más en equipos que programan con IA: pides a un agente que implemente una funcionalidad, te devuelve código rápido, parece correcto, lo pruebas… y descubres que ha hecho exactamente lo que pediste, pero no lo que necesitabas.

Ese es el problema que ataca /grill-me, una de las skills publicadas por Matt Pocock para trabajar mejor con agentes de programación. La idea es sencilla, pero potente: en lugar de escribir prompts cada vez más largos, dejas que el agente te interrogue antes de actuar. Web Reactiva lo resume como una inversión del flujo habitual: el agente no empieza programando, empieza preguntando.

Qué es /grill-me

/grill-me es una skill pensada para evitar el desalineamiento entre intención y ejecución. Cuando activas la skill, el agente debe recorrer contigo el árbol de decisiones de la tarea antes de tocar código.

No te lanza veinte preguntas de golpe. Según el artículo de Web Reactiva, la skill aplica una regla clave: una pregunta cada vez, esperando tu respuesta antes de avanzar. Además, cada pregunta viene acompañada de una recomendación, para que no tengas que decidir desde cero en cada paso.

La diferencia es importante. Un agente normal puede asumir detalles críticos: tipo de paginación, contrato de API, tratamiento de errores, impacto en tests, compatibilidad hacia atrás. /grill-me fuerza a sacar esas decisiones a la superficie.

Por qué esto cambia la forma de programar con IA

El prompting tradicional intenta resolver el problema añadiendo más contexto: más instrucciones, más ejemplos, más restricciones. Eso funciona hasta cierto punto, pero tiene un límite. Siempre habrá una decisión que no escribiste porque no sabías que importaba.

/grill-me cambia la carga cognitiva. Ya no tienes que anticipar todo lo que el agente debería saber. El agente debe descubrir qué necesita saber.

Ese matiz convierte a la IA en algo más parecido a un compañero técnico exigente que a un autocompletado glorificado. No solo ejecuta: desafía el encargo, detecta ambigüedades y te obliga a decidir antes de generar deuda técnica.

La versión para proyectos reales: /grill-with-docs

La evolución natural es /grill-with-docs. Mientras /grill-me sirve para cualquier tarea no trivial, /grill-with-docs está más orientada a repositorios de software. Antes de preguntar, lee documentación del proyecto, especialmente CONTEXT.md y los ADRs existentes en docs/adr/.

Esto resuelve otro problema habitual: el agente puede saber programar, pero no conoce el lenguaje interno de tu producto. Sin contexto, inventa nombres genéricos, confunde conceptos del dominio y propone soluciones que contradicen decisiones pasadas.

Con CONTEXT.md, el agente hereda el vocabulario del proyecto. Con los ADRs, entiende qué decisiones arquitectónicas ya se tomaron y por qué. Web Reactiva destaca que /grill-with-docs no solo lee esos archivos, sino que puede actualizarlos durante la conversación, haciendo que cada sesión deje más contexto para la siguiente.

El verdadero valor: menos velocidad aparente, más velocidad real

La promesa de los agentes de IA suele venderse como velocidad: generar más código en menos tiempo. Pero la experiencia real demuestra que escribir código rápido no siempre significa avanzar rápido.

Si el agente implementa una solución equivocada, el coste aparece después: debugging, refactors, discusiones, tests rotos, regresiones y pérdida de confianza. /grill-me añade una fricción inicial para evitar fricción acumulada.

Es una skill especialmente útil cuando la tarea tiene decisiones implícitas: cambios de arquitectura, endpoints nuevos, refactors, migraciones, reglas de negocio o cualquier implementación donde “hazlo” no sea suficiente.

Cómo encaja con el resto de skills de Matt Pocock

El repositorio no se queda en /grill-me. Web Reactiva menciona otras skills que aplican la misma filosofía a fases distintas del trabajo: /diagnose para debug, /improve-codebase-architecture para detectar módulos superficiales, /to-prd para convertir conversaciones en especificaciones, /to-issues para dividir trabajo en vertical slices y /triage para ordenar issues según su estado.

La idea común es clara: no delegar en la IA una tarea mal definida. Primero se aclara, luego se documenta, después se ejecuta.

Cuándo deberías usar /grill-me

Úsala antes de cualquier tarea que tenga más de una forma razonable de resolverse. Por ejemplo:

• Añadir una funcionalidad con impacto en producto.
• Cambiar una API pública.
• Refactorizar una parte importante del código.
• Diseñar una integración.
• Resolver una deuda técnica ambigua.
• Convertir una idea vaga en trabajo ejecutable.

No hace falta usarla para cambios triviales. Si vas a corregir un typo o renombrar una variable local, probablemente sobra. Pero si una mala decisión puede perseguirte durante semanas, merece la pena que el agente pregunte antes.

Conclusión

/grill-me no es solo una skill para Claude Code, Codex o agentes compatibles con SKILL.md. Es un cambio de mentalidad: dejar de medir la productividad por cuántas líneas genera la IA y empezar a medirla por cuántas decisiones equivocadas evita.

La mejor programación asistida por IA no consiste en escribir prompts perfectos. Consiste en construir un flujo donde el agente entienda el problema antes de resolverlo. Y ahí /grill-me apunta justo al centro del problema.