Back to skills

Agent Skill

Grill With Docs

grill-with-docs

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

MattpocockDocsShell

1M installs

•

mattpocock/skills

•

by Mattpocock

Score

9.5

/ 10

Installs

1M

Repo Stars

270.4K

Last Updated

2d ago

Fresh

Quality Ratio

96%

Description

Verified

Language

Shell

First Published

Apr 2026

Summary

The Grill With Docs agent skill facilitates a rigorous questioning process to refine project plans and designs, simultaneously generating essential documentation like Architecture Decision Records (ADRs) and project glossaries. This agent skill is ideal for developers, solution architects, and technical leads who need to thoroughly validate design choices and ensure comprehensive project documentation from the outset. It is a skill with 800K installs, indicating a high level of adoption among the community. This agent skill operates by instructing the AI agent to execute two distinct phases: a "grilling" phase to rigorously question and refine proposals, and a "domain-modeling" phase to clarify and define project terminology. By systematically invoking these two core processes, it ensures that project designs are thoroughly validated and that a consistent, shared understanding of the domain is established and documented.

Skill Definition

Call the Skill tool twice, for "grilling" and "domain-modeling".

How to Use

Use in O-mega

Claude Code

npx skills add mattpocock/skills grill-with-docs
Grill With Docs | Agent Skills | o-mega