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

717K installs

mattpocock/skills

by Mattpocock

Score

9.4

/ 10

Installs

717K

Repo Stars

215.5K

Last Updated

5d ago

Fresh

Quality Ratio

97%

Description

Verified

Language

Shell

First Published

Apr 2026

Summary

The Grill With Docs agent skill stress-tests a proposed technical plan by relentlessly interviewing the user to align it with the project's existing domain model, terminology, and documented decisions. This agent skill is invaluable for developers and architects planning new features or refactors within an established codebase that values clear domain language and up-to-date architectural records. This is a skill with 280K installs, making it a popular choice for teams prioritizing rigorous design validation and documentation hygiene. It guides the AI agent to systematically explore the plan, ask questions one-by-one, and check against codebase and documentation like `CONTEXT.md` and Architecture Decision Records (ADRs). The skill explicitly directs the agent to challenge conflicting terms against the project's glossary, sharpen vague language, and stress-test domain relationships using concrete scenarios. It ensures `CONTEXT.md` is updated inline as terms are resolved and only suggests creating an ADR when decisions are hard to reverse, surprising without context, and result from real trade-offs.

Skill Definition

Run a /grilling session, using the /domain-modeling skill.

How to Use

Use in O-mega

Claude Code

npx skills add mattpocock/skills grill-with-docs