scoped-grill-with-docs

Runs documentation-aware grilling sessions with numbered questions and a persistent scope ledger.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design and planning interviews often drift off-topic, lose track of question numbering, or forget the agreed scope mid-conversation. This Skill keeps a grilling session anchored to a written scope ledger so every question stays relevant and numbered. ## Core Features & Use Cases - Temporary Scope Ledger: Creates a uniquely named Markdown file in the OS temp directory recording a TL;DR and IN SCOPE list, updated only when the user explicitly refines the goal. - State Control: Switches between GRILLING and DISCUSSION modes so tangents and follow-ups are handled without losing the pending question or its number. - Scope Gating: Re-reads the ledger before every question and rejects out-of-scope questions proposed by the underlying /grilling and /domain-modeling skills, with an explicit SCOPE EXCEPTION block when unavoidable. - Use Case: While grilling a domain model design against project documentation, the user challenges a premise mid-session; the Skill enters DISCUSSION, resolves the concern, then resumes with the correctly numbered next in-scope question. ## Quick Start Ask the assistant to grill my design plan against the domain documentation using scoped-grill-with-docs while keeping every question inside the agreed scope.

Frequently Asked Questions about scoped-grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep a design review session on scope?

Use a scope ledger that records the TL;DR and IN SCOPE items before the first question. The Skill re-reads this ledger before each question and rejects any proposed question that falls outside the agreed scope.

How does the grilling session handle tangents and follow-up questions?

It switches to a DISCUSSION state when the user asks follow-ups or challenges a premise instead of answering. During DISCUSSION no new numbered question is generated, and the session returns to GRILLING once the pending question is resolved.

Where is the scope ledger file stored?

The ledger is a uniquely named Markdown file created in the operating system's temporary directory, resolved with a platform-native facility. It is never written into the repository and contains only a TL;DR block and an IN SCOPE list.

Can an out-of-scope question ever be asked during grilling?

Only when it is necessary to advance the stated TL;DR and no in-scope question can resolve the need. In that case the Skill explains the reason in a SCOPE EXCEPTION block before presenting the question.

What happens if the scope ledger cannot be created or updated?

The session stops before asking another question and reports the failure. This prevents the interview from continuing without a reliable record of the agreed scope.