skills.rest
Ab0umar
Ab0umarCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

Interrogates a plan or design while generating ADRs and a glossary.

Updated Sep 19, 2026
Search Tags:#planning#domain modeling#adr#glossary#interview#design review#architecture decision records
One-click install
npx skills add https://github.com/Ab0umar/selrs.cc.BU --skill grill-with-docs-ab0umar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Ab0umar/selrs.cc.BU/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/Ab0umar/selrs.cc.BU --skill grill-with-docs-ab0umar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague terms, and unexamined trade-offs that surface only during implementation. This Skill runs a relentless structured interview to expose those gaps and captures the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Invokes the grilling skill to challenge a plan or design with probing questions until assumptions and decisions are explicit. - Documentation Generation: Invokes the domain-modeling skill to produce Architecture Decision Records (ADRs) and a domain glossary as the interview progresses. - Use Case: Before starting a new feature, present your draft design and let the interview stress-test it, ending with ADRs that record why each decision was made and a glossary that aligns team terminology. ## Quick Start Ask the assistant to grill your current plan or design and document the decisions as ADRs and a glossary.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stress-test a software design before implementation?▼

Present your plan or design and let the interview process challenge it with probing questions about assumptions, trade-offs, and edge cases. Each resolved question is captured as an Architecture Decision Record for future reference.

What documentation does a design review interview produce?▼

The process produces Architecture Decision Records (ADRs) that capture each decision and its rationale, plus a domain glossary that standardizes terminology. Both artifacts are created incrementally as the interview progresses.

Can this skill be invoked automatically by the AI?▼

No, it sets disable-model-invocation to true and its policy disallows implicit invocation. You must explicitly request it, and it works by calling the grilling and domain-modeling skills.

What are the limitations of an interview-based design review?▼

The quality of the output depends on the answers you provide during the interview, and it does not validate designs against actual code or runtime behavior. It is a reasoning and documentation aid, not a testing or verification tool.

Related Skills

Explore More Software Engineering Skills→
truffle-aitruffle-ai
648

grill-me

Interviews the user about a plan or design to resolve every decision branch.

Official
Basic
akillnessakillness
40

grill-with-docs

Validate architecture plans against project domain language in CONTEXT.md and ADRs.

Community
Advanced
innexar-platinnexar-plat

software-security-appsec

Maps AppSec patterns to OWASP Top 10:2025 and NIST SSDF for secure design.

Community
Advanced
camilooscargbaptistacamilooscargbaptista
7

architecture-review-board

Generate RFC templates, review criteria, and decision logs for architecture governance.

Community
Advanced