Grill me: la skill que interroga tu plan antes de que el agente escriba una línea de código

Grill me es una skill para Claude Code, Codex y otros agentes que hace exactamente lo que dice su nombre: te "pone a la parrilla". Antes de escribir código, el agente te entrevista sin piedad sobre tu plan, ronda tras ronda, hasta que no queda ninguna decisión sin tomar. Es la skill más popular del repositorio mattpocock/skills (licencia MIT) y la que su autor recomienda usar "cada vez que quieras hacer un cambio".

Esta es la segunda parte de la guía de las skills de Matt Pocock. Aquí verás qué problema resuelve, cómo funciona por dentro línea a línea, cómo instalarla y una sesión real completa: cuatro rondas, 20 preguntas y un diseño cerrado sin tocar una línea de código.

El problema: el agente no hizo lo que querías

El README del repositorio abre con una cita de *The Pragmatic Programmer*: "Nadie sabe exactamente lo que quiere". El fallo más común en el desarrollo de software es la desalineación. Crees que el desarrollador sabe lo que quieres, ves lo que construyó y descubres que no te entendió. Con un agente pasa lo mismo, pero más rápido: en dos minutos tienes 400 líneas de código que resuelven un problema que no era el tuyo.

La causa casi nunca es el modelo. Es que tu petición tiene decenas de decisiones implícitas (proveedor, permisos, casos límite, qué pasa si falla) y el agente las rellena con suposiciones razonables pero no tuyas. grill-me saca esas decisiones a la luz antes de que se conviertan en código.

Cómo funciona grill-me por dentro

El SKILL.md de grill-me tiene una sola instrucción: "llama a la skill grilling". Todo el comportamiento vive en grilling, el "primitivo de interrogatorio" que también usan grill-with-docs, triage, wayfinder e improve-codebase-architecture. Son menos de 30 líneas, y cada frase cambia algo concreto:

1. El árbol de decisiones

El agente modela tu plan como un árbol de diseño: cada decisión se ramifica en las decisiones que dependen de ella. Elegir un proveedor de correo abre preguntas sobre dominios y DNS; decidir que tú revisas cada envío abre preguntas sobre un panel de administración.

2. Rondas y frontera

El árbol se recorre en rondas. La frontera son todas las decisiones cuyos requisitos ya están resueltos: lo que se puede preguntar *ahora* sin adivinar respuestas que aún no has dado. En cada ronda el agente pregunta toda la frontera a la vez y espera. Una pregunta que depende de otra todavía abierta va a la ronda siguiente.

Esto es lo que diferencia a grill-me de un "hazme preguntas antes de empezar". Sin la frontera, el agente te hace 25 preguntas de golpe, la mitad sobre ramas que tu primera respuesta va a eliminar.

3. Una recomendación por pregunta

Cada pregunta va numerada y trae la respuesta que el agente recomienda:

❓ **Q1** - **<título>**: <pregunta, puede tener varias opciones>

➡️ <respuesta recomendada>

La skill exige redactar cada pregunta para que un "sí" acepte la recomendación. Así puedes contestar una ronda entera con "Q1 sí, Q2 sí, Q3 no: ..." y solo escribir cuando discrepas.

4. Los hechos son del agente, las decisiones son tuyas

Esta es la regla más importante. Si una pregunta necesita un dato del entorno (qué hay en el código, qué versión usas, qué tablas existen), el agente no te lo pregunta: lanza un subagente con contexto limpio para averiguarlo. Mientras tanto sigue con el resto de la frontera. Las decisiones, en cambio, siempre te las pone delante a ti.

5. Cuándo termina

La sesión acaba cuando la frontera está vacía: cada rama visitada, nada asumido en silencio. Y aun así, el agente no actúa hasta que confirmas que habéis llegado a un entendimiento común.

Cómo instalar y lanzar grill-me

Con el plugin oficial en Claude Code:

claude plugin install mattpocock-skills@claude-plugins-official

O solo con los ficheros, para cualquier agente compatible:

npx skills@latest add mattpocock/skills

Después escribe el comando seguido de tu plan. Con el plugin lleva el prefijo:

/mattpocock-skills:grill-me Quiero añadir una newsletter semanal a mi tienda online...

Si lo instalaste con npx skills, es simplemente /grill-me. Es una skill invocada por el usuario: el agente nunca la lanza por su cuenta, aunque le pidas algo que encaje.

Una sesión real: newsletter para una tienda de bicicletas

Para ver cómo se comporta lanzamos grill-me en Claude Code 2.1.316 con Sonnet 5.5, en una carpeta vacía (sin código del proyecto). El plan de partida era deliberadamente vago:

Quiero añadir una newsletter semanal a la web de mi tienda online de bicicletas (Next.js + Postgres en un VPS). Los clientes se suscriben con su email y cada lunes reciben las ofertas y los productos nuevos de la semana.

Ronda 1: siete preguntas de base

La primera ronda tuvo siete preguntas: proveedor de envío, doble opt-in, baja y cumplimiento legal, quién se puede suscribir, cómo se genera el contenido, qué datos hay en Postgres y cómo se programa el envío. Un detalle que muestra la regla de los hechos: como la carpeta no tenía el código, el agente lo dijo al empezar y marcó la pregunta de la base de datos como un hecho que solo podía darle yo.

Contesté casi todo con "sí". Cambié dos cosas: no quería envío automático (quería revisar cada número) y la hora debía ser de Quito, no de Madrid. También le di el esquema real: products con created_at y una tabla discounts con product_id, percent, starts_at y ends_at.

Ronda 2: mis respuestas reorganizan el árbol

Aquí se ve la frontera en acción. Como pedí revisar cada envío, el cron del lunes dejó de ser "el envío" y pasó a ser "el límite para aprobarlo". La ronda 2 trajo ocho preguntas que antes no tenían sentido:

• Un flujo de revisión: borrador el domingo a las 18:00, aviso por email, aprobación en una página de administración y envío el lunes a las 8:00 solo de lo aprobado.
• Cómo proteger esa página (no había panel de administración).
• Reglas exactas para el contenido usando mi esquema: productos created_at desde el último envío, descuentos activos con starts_at <= now() < ends_at, máximo 8 por sección.
• Qué hacer en una semana sin novedades, cómo evitar envíos duplicados con una clave de idempotencia y un webhook para suprimir rebotes.

Rondas 3 y 4: cerrar el árbol

La ronda 3 tuvo cinco preguntas finas: congelar el contenido al aprobarlo (para que el lunes salga lo que revisé aunque cambie un precio), no importar clientes sin consentimiento, medir con UTM en lugar de píxeles de apertura, borrar datos al darse de baja y hacer un envío de ensayo. También corrigió por su cuenta la normativa: al saber que la tienda era de Ecuador, cambió el RGPD por la LOPDP.

En la ronda 4 ya no quedaban ramas abiertas. El agente entregó un resumen del diseño completo (tablas, flujo semanal, reglas de contenido, fiabilidad y una lista de "pendientes tuyos": DNS, cuenta de Resend y texto legal) y terminó con:

¿Confirmas que es lo que quieres? Cuando me digas que sí, paso a implementar.

Las cifras de la sesión

Lo más valioso no fueron las recomendaciones que acepté, sino las dos que cambié. Una sola, "quiero revisarlo yo", generó un panel de administración, dos crons distintos y la regla de congelar el contenido. Si el agente hubiera empezado a programar con el plan original, todo eso habría salido como retrabajo.

grill-me, grill-with-docs y grilling: cuál usar

Las tres hacen el mismo interrogatorio. Cambia lo que dejan detrás:

El autor es claro: si estás en un directorio de trabajo, usa grill-with-docs, porque hace lo mismo y deja rastro. grill-me es la opción para todo lo que no es código. La veremos a fondo en la parte 4 de esta guía.

Consejos para sacarle partido

• Contesta por número. "Q1 sí. Q2 sí. Q5: quiero revisarlo yo" es más rápido y deja claro qué cambias.
• Discrepa con razones. "12 horas, el taller abre temprano" le da al agente contexto para las preguntas siguientes.
• Dale acceso al código cuando exista. Lanza la skill desde la raíz del proyecto: así resuelve los hechos él solo y te pregunta solo decisiones.
• No le dejes implementar a medias. Si a mitad de sesión le pides "empieza ya", pierdes las ramas que faltaban. Termina las rondas.
• Guarda el resumen final. Es la entrada perfecta para /to-spec, que lo convierte en un spec publicado en tu issue tracker.

Errores frecuentes

• Esperar que salte sola. grill-me lleva disable-model-invocation: true. Hay que escribir el comando.
• Contestar todo en un párrafo. El agente tiene que adivinar qué respuesta va con qué pregunta. Usa los números.
• Aceptar todas las recomendaciones sin leerlas. Las recomendaciones son buenas por defecto, pero son genéricas. En nuestra sesión, la zona horaria por defecto era Madrid.
• Usarla para tareas triviales. Para cambiar el color de un botón, cuatro rondas son demasiado. Resérvala para cambios con decisiones reales.

Preguntas frecuentes

¿Cuánto cuesta una sesión? En nuestra prueba, 0,51 USD con Sonnet 5.5 para 20 preguntas. El coste por ronda sube porque el contexto crece.

¿Funciona en Codex o Copilot? Sí. El repositorio incluye agents/openai.yaml con allow_implicit_invocation: false para que Codex tampoco la lance sola.

¿Puedo usarla sin repositorio? Es justo su caso de uso: planes, decisiones de negocio, charlas o textos. En la siguiente parte de la guía tienes cuatro ejemplos reales fuera del código.

¿Escribe algo en disco? No. Si quieres que guarde glosario y decisiones, usa grill-with-docs.

Siguiente paso

Lanza /grill-me con el próximo cambio que pensabas pedirle directamente a tu agente y cuenta cuántas decisiones no habías tomado. Después sigue con la parte 3: ejemplos reales de grill-me fuera del código, desde migrar un SaaS a un VPS hasta preparar una charla o lanzar un ebook.