mattpocock logo
#5 by installsCoding & architecturemattpocock/skills

grill-with-docs

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

Installs
1.2M
all time
This week
41.2K
installs
Repo stars
276.1K
GitHub
First seen
Apr 28, 2026
on skills.sh
Install
npx skills add https://github.com/mattpocock/skills --skill grill-with-docs
Works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI and other agents that read SKILL.md.
What it does

Relentless design interrogation that stress-tests plans against your domain model and sharpens terminology inline. A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

  • Explores your codebase to ground discussions in existing code, glossaries (CONTEXT.md), and architectural decisions (ADRs)
  • Challenges fuzzy language, resolves terminology conflicts, and updates your domain glossary as decisions crystallize
  • Tests design decisions against concrete scenarios to expose edge cases and boundary violations