About grill-with-docs
A skill for shaping feature decisions while building domain documentation inline. It updates `GLOSSARY.md` and records key trade-offs as ADRs in `docs/adr/`, then stops when the feature is ready for specification or ticket writing.
Key features
- 01Invoke through the "grilling" skill
- 02Build and refine a project glossary
- 03Record key trade-offs as ADRs
- 04Write only designated documentation
Use cases
- 01Clarify feature terminology
- 02Capture decisions during feature design
- 03Prepare a feature for specification or tickets
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/grill-with-docsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
RESUMO.mdTRADUCAO.pt-BR.mdagents/openai.yamlDetails
From the project READMECall the Skill tool with "grilling". As decisions crystallize, build and sharpen the project's domain docs inline: add or tighten glossary terms in GLOSSARY.md, and record load-bearing trade-offs as ADRs in docs/adr/.
Those docs are the only files the session writes. The subject is the feature itself: what it does, who it is for, and the decisions behind it. Writing the work up is someone else's job. to-spec writes the spec, to-tickets writes the tickets. When the frontier is empty, say the feature is ready for one of those and stop there.
Talk in plain language. Prefer the everyday word over the technical one, write a term out in full the first time it appears, and add a one-line explanation whenever a name might mean nothing to the user.