mattpocock avatar

Grill With Docs

This is a structured interrogation tool that stress tests your implementation plan against the actual language and decisions in your codebase. It walks through your design one question at a time, cross references against existing CONTEXT.md glossaries and ADRs, and calls you out when you use fuzzy terminology or contradict documented decisions. Updates documentation inline as terms get resolved. The grill is relentless but practical: it explores your codebase to answer questions instead of guessing, and only creates ADRs when decisions are genuinely hard to reverse. Best used before you start coding, when clarifying domain language actually saves you from building the wrong thing.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
413
skills.sh installs
1.3M
GitHub stars
319.9K
last updated
Aug 21, 2026

Install

$ npx -y skills add mattpocock/skills --skill grill-with-docs --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/mattpocock/skills
Categories
Documentation, Productivity & Planning, Design & UI/UX
First seen
May 16, 2026

More from mattpocock/skills

All 61
1heygen-com avatarfaceless-explainerheygen-com/hyperframesTurn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented522Kskills.sh installs
2xixu-me avataropensource-guide-coachxixu-me/skillsUse when a user wants guidance on starting, contributing to, growing, governing, funding, securing, or sustaining an open source project, or asks about contribu520.1Kskills.sh installs
3obra avatarwriting-plansobra/superpowersUse when you have a spec or requirements for a multi-step task, before touching code298.6Kskills.sh installs
4obra avatarwriting-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment231.3Kskills.sh installs
5addyosmani avatardocumentation-and-adrsaddyosmani/agent-skillsRecords decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that f73.5Kskills.sh installs
6googleworkspace avatarrecipe-draft-email-from-docgoogleworkspace/cliRead content from a Google Doc and use it as the body of a Gmail message.32.3Kskills.sh installs