About grilling
grilling is a facilitation skill for working through design decisions with a user. It maps dependencies as a decision tree, asks all currently answerable questions in rounds, and waits for confirmation of shared understanding before action.
Key features
- 01Dependency-based design tree
- 02Questions grouped by readiness
- 03Recommended answer for each question
- 04Delegation to find environmental facts
- 05Explicit shared-understanding checkpoint
Use cases
- 01Clarifying requirements before implementation
- 02Finding environment facts without burdening the user
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ leandrocfe/ skills --skill grillingAfter installing, type/grillingin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMESabatine o usuário sem dó até chegar a um entendimento compartilhado. Mapeie isto como uma design tree: cada decisão se ramifica nas decisões que dependem dela.
Trabalhe a árvore em rodadas. A frontier é toda decisão cujos pré-requisitos já estão resolvidos — as perguntas que você pode fazer agora sem chutar respostas que ainda não ouviu. Faça a frontier inteira em uma rodada: numere cada pergunta e dê sua resposta recomendada. Depois espere as respostas do usuário antes da próxima rodada.
Cada pergunta deve ser formatada assim:
❓ **Q1** - **<título da pergunta>**: <corpo da pergunta, pode ser vários parágrafos, incluindo múltipla escolha>
➡️ <sua resposta recomendada>
Cada rodada de respostas do usuário remodela a árvore — decisões resolvidas empurram a frontier para fora e destravam perguntas que dependiam delas. Recompute a frontier e faça a próxima rodada. Uma pergunta cuja resposta depende de outra ainda aberta nesta rodada pertence a uma rodada posterior, não a esta.
Achar fatos é seu trabalho, nunca do usuário. Quando uma pergunta da frontier precisa de um fato do ambiente (filesystem, ferramentas, etc.), despache um sub-agent para achá-lo — não peça ao usuário nada que você mesmo poderia buscar. Não bloqueie por isso: uma exploração em andamento é um pré-requisito não resolvido, então só as perguntas a jusante dela esperam o sub-agent reportar — faça o resto da frontier agora. As decisões são do usuário — traga cada uma a ele e espere.
A sessão termina quando a frontier está vazia: cada ramo da design tree visitado, nada deixado silenciosamente assumido. Não aja sobre isso até o usuário confirmar que vocês chegaram a um entendimento compartilhado.