grill-with-docs

Interviews users to sharpen plans and designs while generating ADRs and glossary documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague requirements, and unexamined tradeoffs that only surface during implementation. This Skill runs a relentless structured interview that challenges a plan or design, and captures the clarified decisions as Architecture Decision Records (ADRs) and a shared glossary along the way. ## Core Features & Use Cases - Relentless Interviewing: Runs a grilling session that probes a plan or design until ambiguities and weak assumptions are exposed. - Documentation as a Byproduct: Creates ADRs and glossary entries during the conversation, so decisions and terminology are recorded as they are clarified. - Domain Modeling Integration: Delegates to the domain-modeling skill to structure the interrogation around the problem domain. - Use Case: Before starting implementation of a new service, run a grilling session on your design doc; walk away with a sharpened plan plus ADRs documenting why each key decision was made. ## Quick Start Ask the agent to run a grilling session on your current plan or design document 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 design document before implementation?

Run a grilling session on the design document. The skill interviews you relentlessly about assumptions, tradeoffs, and edge cases, sharpening the plan while recording clarified decisions as ADRs and glossary entries.

How to generate ADRs from a design discussion?

The skill creates Architecture Decision Records automatically during the interview. As each design decision is probed and resolved, it is captured as an ADR, alongside glossary entries for domain terminology.

What documents does a design grilling session produce?

A session produces Architecture Decision Records documenting key decisions and their rationale, plus a glossary defining domain terms. These artifacts are created incrementally as the interview progresses.

Can I use this skill without the domain-modeling skill?

No, the skill explicitly delegates to the domain-modeling skill to run the grilling session. The domain-modeling skill must be available for the interview workflow to function as designed.

When should I not use an interview-based design review?

Avoid it for trivial changes with no architectural impact or when requirements are already fully specified and validated. The interview format adds the most value for ambiguous, high-stakes design decisions.