grill-all

grill-all: source-aware plan review for Claude Code, Codex, and AI coding agents

grill-all is a source-aware plan-review skill that helps Claude Code, Codex, and other AI coding agents pressure-test implementation plans. It routes unresolved questions to the right source: project docs, the codebase, human intent, or current web documentation.

Inspired by grill-me and grill-with-docs, grill-all helps an agent stress-test a coding plan while deciding where each answer should come from: the human, project docs, the codebase, or the web.

Why this exists

Coding agents often fail in two opposite ways:

• They ask humans questions that docs or code could answer.
• They proceed through decisions that actually require human intent, taste, priority, or risk acceptance.

grill-all teaches the agent to route each unresolved question to the right source of truth.

When to use it

Use grill-all when you want an agent to challenge a plan, design, refactor, migration, or feature before or during implementation.

It is especially useful when:

• you are vibe coding but still want the agent to stop for real product decisions;
• the project has docs, ADRs, OpenSpec files, issues, or code patterns the agent should inspect before asking you;
• the task may depend on current external facts such as SDK docs, API behavior, framework changes, or ecosystem guidance;
• you want grill-me-style questioning without being asked things the agent can verify itself.

How it behaves

grill-all chooses its interaction mode from your prompt:

• Grill-heavy: if you ask to be grilled, challenged, pressure-tested, or repeatedly confirmed.
• Autonomous: if you ask for vibe coding, autonomous execution, or "don't ask unless blocked".
• Ask once: if your prompt does not say, the agent asks whether you prefer more confirmation questions or more autonomous source-checking.

Then it routes questions:

• project facts → docs, specs, ADRs, issues, README, OpenSpec;
• implementation facts → codebase, tests, types, call sites;
• human decisions → one question at a time, with a recommended answer;
• current external facts → official web docs and primary sources.

Installation

grill-all supports Codex, Claude Code, and generic coding agents:

• Codex users can install it as a plugin or use the repo-scoped .agents/skills/grill-all/SKILL.md copy.
• Claude Code users can copy the skill into their user skills directory.
• Generic agents can read skills/grill-all/SKILL.md directly.

Codex

As a Codex plugin

Add this repo as a Codex plugin marketplace:

codex plugin marketplace add zhjai/grill-all

Then open Codex and install grill-all from the plugin marketplace.

This repository includes the Codex plugin entrypoint at .codex-plugin/plugin.json, with the plugin skill copy in .codex-plugin/skills/grill-all/SKILL.md.

As a repo-scoped Codex skill

If you want to use grill-all inside another project without installing the plugin, copy the skill to that project's .agents/skills directory:

mkdir -p .agents/skills
cp -R skills/grill-all .agents/skills/grill-all

Codex discovers repo-scoped skills from .agents/skills while working in that repository.

This repo also includes .agents/skills/grill-all/SKILL.md, so Codex can discover grill-all automatically when run from this repository.

Claude Code

As a Claude Code plugin

Add this repo as a Claude Code plugin marketplace:

claude plugin marketplace add zhjai/grill-all

Then install the plugin:

claude plugin install grill-all@grill-all-marketplace

Or inside Claude Code:

/plugin marketplace add zhjai/grill-all
/plugin install grill-all@grill-all-marketplace

This repository includes the Claude Code marketplace at .claude-plugin/marketplace.json, and the plugin itself at plugins/grill-all/.

As a Claude Code user skill

Install the skill into your user skills directory:

mkdir -p ~/.claude/skills
cp -R skills/grill-all ~/.claude/skills/grill-all

Or install it into a project-specific skills directory if your setup loads project skills.

Codex user skill

You can also install the skill into your Codex user skills directory:

mkdir -p ~/.agents/skills
cp -R skills/grill-all ~/.agents/skills/grill-all

If your coding agent setup does not auto-load skills, paste skills/grill-all/SKILL.md into the session or reference it from your project instructions.

Any coding agent

Copy or reference:

skills/grill-all/SKILL.md