Back to Skills
mattpocock•0•Other
Grill With Docs
Runs a grilling session that sharpens a software plan and creates ADR or glossary documentation.
Installation Commandexplicit
$ npx skills add mattpocock/skills --skill=grill-with-docs
About
Grill With Docs is an engineering skill in mattpocock/skills. Its SKILL.md describes a relentless interview to sharpen a plan or design while creating docs, including ADR's and a glossary, as you go. It runs a /grilling session using the /domain-modeling skill.
Key Features
- Interviews the user about a plan or design one question at a time.
- Writes resolved terminology to
CONTEXT.mdand records hard-to-reverse decisions as ADRs. - Uses codebase reading to answer questions the codebase can answer.
- Acts as the opening step in the documented flow:
grill-with-docs → to-prd → to-issues → implement → code-review.
Use Cases
- Aligning a fuzzy software change before implementation.
- Sharpening domain language and canonical terms before writing a PRD.
- Leaving a documentation trail in
CONTEXT.mdanddocs/adr/.
Requirements
- A workspace where the agent is allowed to write documentation files.
npxfor the documented install command.- No required environment variables were found in the verified sources.
Installation
Install command: npx skills add mattpocock/skills --skill=grill-with-docs
Sources
- Source: https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md
- Repository: https://github.com/mattpocock/skills
- Install source: https://www.aihero.dev/grill-with-docs
SKILL.md
--- name: grill-with-docs description: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. disable-model-invocation: true --- Run a `/grilling` session, using the `/domain-modeling` skill.
Related Skills
More workflow tools in the Other category.
Compatible MCP Servers
Power these skills with protocol-compliant data sources.
