# grill-with-docs

Conducts an intense review interview on an engineering plan or design, generating ADR records and glossary definitions as decisions are settled.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 365 installs · ★ 51
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/grill-with-docs/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/akillness-grill-with-docs

## What it does

The skill initiates an aggressive questioning session to pressure-test plans and technical designs. Instead of passively agreeing with proposals, the assistant probes edge cases and trade-offs. As the conversation progresses, it translates established choices directly into architecture decision records and builds out domain vocabulary files.

Behind the scenes, the workflow bridges deep questioning with domain modeling. The assistant inspects the workspace using tools such as `Read`, `Grep`, `Glob`, and `Bash` to confirm codebase facts independently instead of pestering the developer.

Control returns to the engineer at designated decision gates. The procedure expects small reversible adjustments. Assumptions must be stated plainly.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill grill-with-docs -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/grill-with-docs/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/grill-with-docs/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill grill-with-docs -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/grill-with-docs/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill grill-with-docs -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/grill-with-docs/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills grill-with-docs
```

2. **Manually: put the files in place**
- File: `.github/skills/grill-with-docs/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill grill-with-docs -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/grill-with-docs
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/grill-with-docs/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill grill-with-docs -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/grill-with-docs/SKILL.md

## When to use it
- stress-test a proposed technical architecture before writing code
- generate architecture decision records during the review dialog
- capture domain terms in an updated project glossary
- surface hidden design assumptions using codebase inspection

## Example prompts
- Grill this event streaming design and write the ADR.
- Run a thorough critique on the user migration plan and extract glossary terms.
- Grill and document our microservice auth workflow.

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

## Other versions with the same name
- [grill-with-docs · mattpocock](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — 1219756 installs
- [grill-with-docs · alirezarezvani](https://affpapa.org/en/nevibecode/skills/alireza-rezvani-grill-with-docs.md) — 100 installs
- [grill-with-docs · haowjy](https://affpapa.org/en/nevibecode/skills/haowjy-grill-with-docs.md) — 514 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 65 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md