grill-me: prima ti fa le domande

Cos'è e perché conta

Chiedi a Claude una cosa, lui parte e ti consegna tutt'altro. Non ha scritto male il codice: ha capito un'altra cosa. E tu rifai tutto da capo. Il README della raccolta mattpocock/skills lo chiama il problema più comune di chi costruisce software.

grill-me fa il contrario. Prima di lavorare, Claude cerca da solo quello che trova nei tuoi file, poi ti fa le domande a giri, numerate, ognuna con la risposta che ti consiglia: se ti va bene, dici solo sì. Le decisioni restano tue, e non passa all'azione finché non confermi che vi siete capiti.

È una skill, cioè un pacchetto di istruzioni per Claude Code, dentro mattpocock/skills: una raccolta gratuita, con licenza MIT e più di 300.000 stelle su GitHub a fine ottobre (le stelle sono della raccolta intera). Il README dice «non vibe coding». Secondo me per chi costruisce senza leggere il codice conta ancora di più: se il come non lo controlli, mettervi d'accordo sul cosa è la difesa migliore che hai.

1. Installalo: due modi, scegline uno

Il README è chiaro: un modo solo, perché se li installi tutti e due ti ritrovi ogni skill doppia.

Modo 1: il plugin, che si aggiorna da solo

È quello che consiglio. Sta nel marketplace ufficiale di Anthropic, il catalogo di plugin che Claude Code conosce già, con il nome mattpocock-skills. Lancia questa riga nel terminale, fuori da Claude Code:

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

Lo installa per te, in tutti i tuoi progetti. Si carica alla prossima sessione, o con /reload-plugins in quella aperta. Se su quel computer non hai mai aperto Claude Code nel terminale, prima lancia claude plugin marketplace add anthropics/claude-plugins-official.

Per controllare, scrivi / nella chat: le skill di un plugin hanno il suo nome davanti. Cerca questa:

/mattpocock-skills:grill-me

Con il plugin il comando ha il nome del plugin davanti, ed è quello con cui l'ho provato io; con i file del modo 2 è /grill-me. Gli aggiornamenti del plugin arrivano da soli.

Modo 2: i file nel progetto, che aggiorni tu

Se vuoi i file da leggere e cambiare, lancia questa riga dalla cartella del progetto. Ti serve una versione recente di Node.js, il programma che fa girare npx.

npx skills@latest add mattpocock/skills

1. Tra gli strumenti scegli Claude Code.
2. Tra le skill prendi grill-me e anche grilling: grill-me da solo chiama grilling, che contiene le istruzioni vere.
3. Apri Claude Code nella cartella e scrivi /grill-me.

Le installa nel progetto in cui sei; con -g le hai in tutti. Per aggiornarle: npx skills@latest update.

2. Come si usa: la richiesta, poi i giri di domande

grill-me non parte da solo: Claude non può lanciarlo di sua iniziativa, lo lanci tu. Scrivi il comando e, subito dopo, cosa vuoi fare, con parole tue. Cambia le parti tra [ ]:

/mattpocock-skills:grill-me Voglio [aggiungere una pagina con i prezzi]. È per [chi la usa] e serve a [il problema che risolve].

Da lì le istruzioni di grilling dicono a Claude di lavorare così:

• I fatti li cerca lui: quello che può scoprire da solo non te lo chiede, manda un sub-agente (un aiutante separato) a cercarlo.
• Le decisioni le prendi tu: ogni domanda è numerata e ha sotto la risposta che consiglia, scritta in modo che un sì la accetti.
• Un giro contiene solo le domande a cui puoi rispondere adesso; le altre aspettano il giro dopo.
• Finisce quando niente resta deciso in silenzio, e non agisce finché non confermi che vi siete capiti.

Per rispondere basta un sì. Se una risposta non ti torna, dillo con il suo numero:

Sì a tutte tranne la 2: [la tua scelta]. Sulla 4 ho un dubbio: [il dubbio].

3. Un mio giro di domande vero

L'ho provato il 30 ottobre in Claude Code, sul codice del mio sito, con il plugin. Ho lanciato /mattpocock-skills:grill-me con questa richiesta: «Voglio aggiungere al sito una pagina «le guide di questa settimana», con la copertina di ogni video, così chi commenta GUIDA sotto un video vecchio trova la guida giusta anche se in cima a /guida ce n'è già una più nuova.»

Prima di qualsiasi domanda ha guardato il codice da solo, e mi ha scritto cosa c'era già:

• /guida è una lista unica, ordinata dalla guida più nuova.
• Non c'è un campo per la copertina o per il link al video, e le copertine stanno fuori dal codice del sito.

Poi ha scritto che le domande non dipendevano l'una dall'altra, e me le ha fatte tutte in un giro. Sei, ognuna con la sua risposta consigliata (le ho accorciate):

1. Da dove arrivano le copertine? Consiglio: un campo copertina facoltativo in ogni guida; le immagini le estrae lui dai reel che ho sul computer.
2. Cosa vuol dire «questa settimana»? La trovi qui sotto, parola per parola.
3. Indirizzo e lingue? Consiglio: /guida/settimana, in tutte le lingue del sito, come /guida.
4. Come ci arriva chi commenta GUIDA? Consiglio: un blocco ben visibile in cima a /guida che porta alla pagina nuova; i social non li tocca.
5. Cosa mostra ogni card? Consiglio: copertina, titolo, numero e data, dalla più nuova. Niente descrizione: chi arriva deve riconoscere il video dalla copertina.
6. E dopo la settimana? Consiglio: la guida esce da questa pagina e resta in /guida, senza un archivio per settimane, per ora.

La domanda 2, com'è arrivata

❓ Q2 - Cosa vuol dire «questa settimana»: sono le guide con date negli ultimi 7 giorni, calcolati ad ogni build. Se ce ne sono meno di 7, la pagina completa fino a 7 con le più recenti, così non resta mai quasi vuota. Un'alternativa è la settimana di calendario, da lunedì a domenica.

➡️ Sì: ultimi 7 giorni mobili, con riempimento fino a 7 guide. La settimana di calendario fa sparire tutto ogni lunedì, proprio quando chi commenta sotto il video di domenica arriva.

Nella richiesta «questa settimana» sembrava chiaro, ma le strade erano due, e una svuotava la pagina ogni lunedì. Senza domande, quella scelta l'avrebbe fatta Claude. A te basta un sì, o la tua scelta su quel numero.

4. Quando usarlo, e in che ordine

Il README dice di usarlo a ogni modifica. Io lo tengo per quelle dove una parola può voler dire due cose: una pagina nuova, una funzione, il login. L'ordine:

1. grill-me: vi mettete d'accordo su cosa fare.
2. Plan mode: Claude scrive come lo farà, file per file, e non modifica niente finché non approvi. Come lo uso io è nella guida PIANO.
3. Il codice, solo dopo che hai approvato il piano.

A giri finiti passo al piano scrivendo /plan davanti al messaggio:

/plan Fai il piano di quello che abbiamo deciso nelle domande. Se ti serve una scelta che non era nelle risposte, chiedimela prima di scriverla nel piano.

E lo schema in tre righe della guida PROMPT? Lì scrivi tu una richiesta chiara; grill-me cerca quello che nella richiesta manca. Vanno bene insieme. È troppo, invece, per un refuso, un colore, una modifica da una riga: lì chiedila e basta.

grill-me o grill-with-docs?

Il README presenta grill-me per piani, idee e design, anche fuori dal codice. Per il codice c'è grill-with-docs: le stesse domande, più un glossario del progetto (GLOSSARY.md) e gli ADR, brevi documenti che fissano una decisione e il perché. Prima va lanciato una volta per progetto setup-matt-pocock-skills.

Gli errori più comuni

• Installare il plugin e anche i file con npx: ogni skill due volte. Scegline uno.
• Con npx, prendere grill-me senza grilling: resta senza istruzioni.
• Dire sì a tutto senza leggere: le risposte consigliate sono ipotesi, non decisioni.

Checklist

• Ho installato grill-me in un modo solo
• Scrivendo / in Claude Code vedo grill-me
• Dopo il comando ho scritto la richiesta con parole mie
• Ho letto ogni risposta consigliata prima di dire sì
• Solo dopo l'ultimo giro sono passato al plan mode

Domande frequenti