grill-and-record
Installation
SKILL.md
Grill and Record
Use this skill only when the user explicitly asks for grilling plus durable documentation or directly invokes this skill. Complexity, ambiguity, or a possible need for docs alone never activates it. This skill carries its own interview and documentation contract. Do not load or invoke grill or domain-modeling at runtime.
Interview Contract
- Research discoverable facts in the repository, issue, docs, and code before asking the user. Ask only for judgments or facts that cannot be discovered.
- Ask one decision-forcing question at a time. State the recommended answer and the reason briefly, then wait for the answer.
- Prefer the host's structured input surface for bounded decisions:
- Use
request_user_inputwhen it is exposed and the decision fits 2-3 short, mutually exclusive choices. Put the recommended answer first. Send one question per call withid,header,question, andoptions; omitOtherandNonebecause the client provides a free-form escape. Never set the top-levelauto_resolution_msin a grilling interview: a grilling decision always waits for the human answer, because auto-resolving to the recommended default is never safe when the whole point of the interview is the user's judgment. - On Claude Code, use
AskUserQuestionfor the same bounded choice. - Use plain chat only when the structured surface is unavailable or the answer needs free-form discussion. Never pose a bounded checkpoint as plain assistant text or as a free-form question before offering structured choices.
- Use
- Use comparison tables only when the user explicitly requested one or the question concerns agent-product behavior, such as Claude Code versus Codex.
- Follow dependent decisions until the skill decides the decision tree is exhausted. Never ask a final "are we done?" meta-question.
- Summarize the settled contract: goals, non-goals, decisions, constraints, risks, validation, and unresolved items.
Ending the interview never authorizes implementation. Implement only after a separate explicit user request.