Call the Skill tool twice, for "grilling" and "domain-modeling".
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
Ask your Agent
Use this Skill: https://skilld.dev/gh/mattpocock/skills/grill-with-docs
This session only. Nothing lands on disk.
≈31 tokens always: the name and description. ≈16 when used: this file. ≈37 more on demand in 1 file.
Source: SKILL.md on GitHub
Third-party checks
No alerts17d3 checks · Risk SAFE
- Gen Agent Trust Hub17d
The skill is a configuration-only package designed to facilitate design reviews and documentation. It contains no executable code, network operations, or sensitive file access.
- Socket17d
No alerts
- Snyk17d
Risk: LOW · No issues
Provenance
Signed by skilld at 447ca70. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.
Last checked against GitHub 2 days ago.
Activeupdated 2 months ago
Capability
- disable-model-invocation
- true
Topics
- Documentation
- domain-modeling
- adr
- decision-making
- terminology
- codebase-analysis
- context-mapping
README badge
What it does
Conducts a structured interview about your design plan, walking through each decision branch while checking terminology against your existing domain model and codebase. Updates CONTEXT.md and ADRs inline as shared understanding crystallizes, surfacing contradictions between stated behavior and code implementation.
Generated from the current SKILL.md.
Frequently asked
Does this skill update code, or just documentation?
It only updates documentation (CONTEXT.md and ADRs). The skill challenges your plan against the domain model and existing decisions, but does not generate code.
What if my repo doesn't have CONTEXT.md or an ADR directory yet?
The skill creates them on-demand as decisions are resolved. Files are only written when there's concrete content to capture.
How does this differ from a regular design review?
This skill stress-tests decisions against your codebase and existing glossary, surfacing contradictions between what you say and what the code does. It also updates domain documentation inline as terms are sharpened.
Can this work with multiple bounded contexts?
Yes. If your repo has a CONTEXT-MAP.md at the root, the skill will look for context-specific CONTEXT.md and ADR directories inside each bounded context folder.
Generated from the current SKILL.md. These answers refresh after source changes.