skills.rest
tajo9128
tajo9128COMMUNITY
Explore all skills by this author →
Website𝕏@hosting_hydGitHub

grill-with-docs

Interrogates a plan or design through structured questioning while generating ADRs and a glossary.

2|Updated May 12, 2026
Search Tags:#architecture#documentation#domain modeling#adr#glossary#interview#design review
One-click install
npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill grill-with-docs-tajo9128
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/tajo9128/BioDockify-Pharma-AI/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill grill-with-docs-tajo9128

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague requirements, and undocumented decisions that surface too late. This Skill runs a relentless interview session that stress-tests a plan or design while capturing the outcomes as Architecture Decision Records (ADRs) and a project glossary. ## Core Features & Use Cases - Structured Grilling Session: Runs a /grilling interview that challenges assumptions, edge cases, and design choices in a plan. - Documentation as a Byproduct: Creates ADRs and a glossary incrementally as the interview progresses, so decisions are recorded the moment they are made. - Domain Modeling Integration: Builds on the /domain-modeling skill to ground questions in the domain model. - Use Case: Before implementing a new service, run a grilling session on the design proposal; the session exposes gaps in the plan and leaves behind ADRs and a shared vocabulary for the team. ## Quick Start Ask the agent to run a grilling session on your current design document so it can challenge the plan and produce 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 design document with an AI interview?▼

Run a grilling session on the design document. The skill asks relentless clarifying questions about assumptions, edge cases, and trade-offs, and records the resolved decisions as ADRs and glossary entries as the session progresses.

What documentation does a grilling session produce?▼

A grilling session produces Architecture Decision Records (ADRs) capturing each decision and its rationale, plus a glossary defining the domain terms used. These documents are created incrementally during the interview rather than afterward.

Does grill-with-docs work without the domain-modeling skill?▼

No, the skill explicitly instructs the agent to run the grilling session using the domain-modeling skill. The domain model provides the grounding for the interview questions, so that skill must be available first.

Can the grilling session be triggered automatically by the model?▼

No, the skill sets disable-model-invocation to true and its policy disallows implicit invocation. It only runs when the user explicitly requests a grilling session.

When should I use a grilling session instead of a normal design review?▼

Use it when a plan or design is still forming and you want assumptions challenged before implementation. It is less suitable for finalized designs where decisions are already locked and documented.

Related Skills

Explore More Software Engineering Skills→
YYG501YYG501
4

grill-with-docs

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

Community
Basic
slashwhyslashwhy
5

architectural-documentation

Generate templates for implementation plans, ADRs, API specifications, and migration guides.

Official
Basic
f-campanaf-campana

design/validator

Compare HTML output against a Design Contract and write a findings-only validation report.

Community
Intermediate
launchapp-devlaunchapp-dev
38

design-review-process

Codify a four-gate design review process with criteria, checklists, and approvals.

Official
Advanced