# Grill With Docs

> Interview the plan one sharp question at a time, inspect local docs before asking, and save clear decisions back into the right repo docs.

- Skill: `joelhooks/grill-with-docs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add joelhooks/grill-with-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joelhooks/grill-with-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: joelhooks (https://skillmd.com/u/joelhooks)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/joelhooks/grill-with-docs

---


# Grill With Docs

Use this skill when the project needs clearer intent before product behavior or architecture changes.

This is a local adaptation of Matt Pocock's `grill-me` pattern from `mattpocock/skills`: be relentless, ask one good question at a time, and help the user sharpen the plan instead of guessing.

## Before asking

Inspect the repo first. Prefer these files when they exist:

- `VISION.md`
- `AGENTS.md`
- `README.md`
- local docs under `docs/`
- nearby issue, plan, or decision notes

If a file can answer the question, read it instead of asking the user.

## How to run the grill

1. State the current assumption in one sentence.
2. Ask exactly one question.
3. Include a recommended answer, clearly labeled, so the user can accept, reject, or edit it.
4. Wait for the user's answer before asking the next question.
5. When a decision becomes clear, save it in the right place:
   - `VISION.md` for product intent, boundaries, stop points, and non-goals.
   - `AGENTS.md` for operational rules future agents must follow.
   - `README.md` or `docs/` for user-facing setup or usage notes.

Keep the skill small. Do not create PRDs, issue workflows, ADR systems, or implementation scaffolding unless the user explicitly asks for that next.