grill-with-docs

Interrogates a plan or design and updates decision records and glossary documentation.

6|2|Updated May 6, 2026
One-click install
npx skills add https://github.com/sek788432/Stock-Back-Test-System --skill grill-with-docs-sek788432
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/sek788432/Stock-Back-Test-System/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/sek788432/Stock-Back-Test-System --skill grill-with-docs-sek788432

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions, ambiguities, and undocumented decisions. This Skill runs a structured interview that challenges a plan or design while capturing the outcomes in living decision records and a project glossary. ## Core Features & Use Cases - Relentless design interview: Runs a grilling session that probes a plan or design with sharp questions to expose gaps and weak assumptions. - Living documentation updates: Writes outcomes into living important decisions and the project glossary as the session progresses. - Domain modeling integration: Uses the domain-modeling skill to structure the interrogation around the problem domain. - Use Case: Before implementing a new backtesting feature, run a grilling session on the design proposal so unresolved questions surface early and every accepted decision is recorded in the decision log. ## Quick Start Ask the agent to grill the current design proposal for the backtest replay feature and record the decisions in the project docs.

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 that interviews you about the design with relentless questions, exposing hidden assumptions and gaps. Outcomes are written into living decision records and the project glossary as the session progresses.

What is a grilling session for design review?▼

A grilling session is a structured interview where the agent challenges your plan or design with probing questions. It uses domain modeling to frame the interrogation and documents every accepted decision along the way.

Does this skill write code or only documentation?▼

It only produces documentation. The session updates living important decisions and the glossary; it does not generate or modify source code.

Can I use the grill-with-docs skill on an existing design?▼

Yes, it works on any existing plan or design, not just new proposals. The interview format surfaces weaknesses regardless of how mature the document is.

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

The quality of the outcome depends on your answers; it cannot verify technical feasibility or run code. For validation of implementation details, pair it with prototyping or code review.