Agent skill · writing content · sickn33
grill-with-docs
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
Why this skill is useful
Provides structured documentation generation for architectural decision records and glossaries that the AI wouldn't reliably create on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
When to Use Use when this workflow matches the user request: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. Source: mattpocock/skills (MIT). Use the installed grilling procedure to ask one meaningful question at a time. Inspect existing ADR/glossary conventions first. Record only confirmed answers in authorized project docs, mark open proposals as Proposed, preserve conflicting alternatives and review the resulting diff. Use domain-modeling only if installed and relevant; do not invent a slash-command dependency. Example User request: Use @grill-with-docs for this task: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. Limitations Requires the upstream tool, account, API key, or local setup when the workflow names one. Does not authorize destructive, production, paid, or external-message actions without explicit user approval. Validate generated artifacts or recommendations against the user's real sources before treating them as final.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/grill-with-docs