grill-with-docs

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

Updated Sep 4, 2026
One-click install
npx skills add https://github.com/yngvebn/lunsjkokk-helper --skill grill-with-docs-yngvebn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/yngvebn/lunsjkokk-helper/tree/main/.claude/skills/grill-with-docs
Command: npx skills add https://github.com/yngvebn/lunsjkokk-helper --skill grill-with-docs-yngvebn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions and vague terminology that only surface during implementation. This Skill runs a relentless interview that stress-tests your plan or design and captures the decisions and vocabulary it uncovers as documentation. ## Core Features & Use Cases - Design Interrogation: Challenges your plan with probing questions by invoking a grilling workflow to expose weak assumptions and gaps. - Documentation as a Byproduct: Produces Architecture Decision Records (ADRs) and a glossary while the interview progresses, via a domain-modeling workflow. - Use Case: Before starting a new service, present your draft architecture and let the interview pin down ambiguous terms and record each resolved trade-off as an ADR. ## Quick Start Ask the assistant to grill my current design plan and produce ADRs and a glossary from the discussion.

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 workflow challenge it with probing questions. Weak assumptions and gaps surface through the questioning, and each resolved decision is captured as an Architecture Decision Record.

How to generate ADRs from a design discussion?▼

Run the interview on your design and the domain-modeling workflow records decisions as ADRs while building a glossary of terms. Documentation emerges as a byproduct of the conversation rather than a separate writing task.

What outputs does a design grilling session produce?▼

The session produces Architecture Decision Records documenting resolved trade-offs and a glossary defining domain terms. These artifacts are created incrementally as the interview uncovers decisions and ambiguous vocabulary.

Can this skill be invoked automatically by the AI?▼

No, the skill sets disable-model-invocation and its agent policy disallows implicit invocation. It only runs when explicitly invoked, and it works by calling two other skills named grilling and domain-modeling.

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

The skill contains no scripts or reference material of its own and depends entirely on the grilling and domain-modeling skills being available. Without those sub-skills installed, the orchestration instructions cannot execute.