grill-with-docs

Interrogate a proposed design through focused questions before writing durable documentation.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/sciman-top/skills-manager --skill grill-with-docs-sciman-top
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/sciman-top/skills-manager/tree/main/overrides/patches/grill-with-docs
Command: npx skills add https://github.com/sciman-top/skills-manager --skill grill-with-docs-sciman-top

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design proposals often hide untested assumptions, unclear seams, and unresolved tradeoffs that only surface during implementation. This Skill runs a structured grilling interview that challenges a design one decision at a time, so only confirmed conclusions become ADRs, glossary entries, or CONTEXT.md updates. ## Core Features & Use Cases - Focused design interrogation: Asks one high-leverage question at a time, keeping the current decision, alternatives, constraints, and open questions visible throughout the session. - Native child-agent dispatch: Delegates the multi-turn interview to a host-native spawned agent with strict attribution rules for human answers versus authorized AI delegate answers. - Durable documentation gating: Updates CONTEXT.md, glossaries, or ADRs only after the user confirms a decision; otherwise returns a structured summary without writing files. - Use Case: A team proposes a new event-sourcing architecture. Use this Skill to grill the design on consistency boundaries, failure modes, and vocabulary before committing anything to an ADR. ## Quick Start Ask the assistant to grill your proposed design or plan and challenge its assumptions one decision at a time before documenting anything.

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 proposal before writing an ADR?▼

Run a design grilling interview that asks one high-leverage question at a time about assumptions, seams, and tradeoffs. Only after you confirm a durable decision does the workflow record it in an ADR, glossary, or CONTEXT.md.

What is a design grilling interview in AI-assisted workflows?▼

It is a structured interrogation where the assistant challenges a proposed design decision by decision, keeping alternatives, constraints, and unresolved questions visible. The goal is to expose weak assumptions before they become permanent documentation.

Can this skill brainstorm or implement the design it reviews?▼

No. Brainstorming, implementation, and refactoring requests are treated as out of scope unless the user also explicitly asks for design grilling. It also never publishes specs, tickets, or architecture scans on its own.

What happens if the native agent spawn capability is unavailable?▼

The skill stops with a native_bridge_unavailable status instead of simulating the interview in the parent context. It will not fall back to a one-shot analysis, report, or summary as a substitute for the child-agent interview.

When does the skill write to CONTEXT.md or an ADR?▼

Files are written only after the user confirms a durable decision or explicitly requests the record. If the interview ends without a confirmed decision, it returns a structured summary and writes nothing.