grill-with-docs

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

1|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/filippolmt/skills --skill grill-with-docs-filippolmt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/filippolmt/skills/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/filippolmt/skills --skill grill-with-docs-filippolmt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions and weak spots that only surface under questioning, and the decisions made during review are rarely documented. This Skill runs a relentless interview to sharpen a plan while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Relentless Interview: Runs a grilling session that challenges assumptions and stress-tests a plan or design. - Documentation as Output: Creates Architecture Decision Records (ADRs) and a glossary as the interview progresses. - Use Case: Before implementing a new system design, invoke this Skill to have your plan interrogated question by question, ending with ADRs and a shared glossary that record why each decision was made. ## Quick Start Ask the assistant to grill my current design plan and produce ADRs and a glossary as we go.

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?

Run a grilling session on your plan or design, where the assistant relentlessly questions assumptions and decisions. This Skill also documents the outcomes as ADRs and a glossary while the interview proceeds.

How to generate ADRs during a design review?

Invoke this Skill with your design plan; it runs an interview using the grilling and domain-modeling skills and writes Architecture Decision Records and a glossary as decisions are made during the session.

Does grill-with-docs work on its own?

No, it depends on two sibling skills: grilling for the interview and domain-modeling for the documentation. Install the bundle or both dependencies, otherwise the skill's calls find nothing and it silently does less.

Can this Skill be triggered automatically by the model?

No, it sets disable-model-invocation to true and its agent policy disallows implicit invocation. You must invoke it explicitly when you want a plan or design interrogated.

What documentation does a grilling session produce?

The session produces Architecture Decision Records capturing design decisions and a glossary defining domain terms. Both are written incrementally as the interview progresses rather than after the fact.