grill-me

Interviews the user about a plan or idea and checkpoints every answer into a markdown brainstorm file.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/Raynos/kami-kakushi --skill grill-me-raynos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-me
Source: https://github.com/Raynos/kami-kakushi/tree/main/.claude/skills/grill-me
Command: npx skills add https://github.com/Raynos/kami-kakushi --skill grill-me-raynos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long planning or brainstorming conversations lose decisions, conflate answers, and overflow context. This Skill turns an interview into a durable markdown capture file so every answer, flag, and tangent is preserved as the source of truth. ## Core Features & Use Cases - Checkpointed Q&A capture: After every user answer, a structured entry (question topic, key facts, flags with owners) is appended to project/brainstorms/{date}-{topic}.md before the next question is asked. - Structured interview method: One question at a time with a recommended answer, dependency-ordered resolution, and a parking lot for tangents cross-linked to PARKED-THREADS.md. - Session wrap-up: Reconciles contradictions, promotes settled decisions to docs and ADRs, commits a snapshot, and recaps what is captured versus still pending. - Use Case: You have a half-formed feature design in your head. Ask to be grilled, and the Skill walks every branch of the decision tree while writing a complete discovery document you can hand to your team. ## Quick Start Say "grill me about the new caching design" and answer each question while the Skill logs everything to a brainstorm file.

Frequently Asked Questions about grill-me

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

FAQPage Schema
How do I capture decisions from a brainstorming session?

Start a grilling session and the Skill creates a dated markdown file under project/brainstorms, then appends a structured entry after every answer. Each entry records the question topic, key facts in your words, and open flags with owners.

How do I stress-test a plan or design before building it?

Ask to be grilled on the plan. The Skill walks each branch of the decision tree one question at a time, offers a recommended answer you can confirm or correct, and resolves upstream dependencies before their dependents.

What happens to tangents and side ideas during the interview?

Tangents are captured under a Parking lot section in the capture file and cross-linked from project/brainstorms/PARKED-THREADS.md. This keeps divergent threads recallable across sessions without derailing the active line of questioning.

What happens when the interview session ends?

The Skill rereads the capture file to reconcile contradictions, promotes settled decisions to docs and an ADR in docs/living/decisions.md, commits one snapshot, and recaps what is captured versus still pending.

What are the limitations of an interview-based capture approach?

The capture quality depends on the user's answers; questions the user cannot answer become flags assigned to an owner rather than resolved decisions. It also does not replace formal specification review for implementation-ready designs.