The repo provides a skill for grilling unknowns before implementation, outlining its purpose, usage, and integration into agent ecosystems. It includes installation steps and example prompts, plus a package structure. It has 177 stars and MIT license.
What it is
grill-for-unknowns is described as an agent skill for finding unknowns, grilling plans, and reaching shared understanding before implementation. It combines docs/source-grounded plan interrogation with a four-quadrant strategy (known knowns, known unknowns, unknown knowns, unknown unknowns).
How it works
The skill emphasizes inspecting the real territory first, grilling the plan and user where decisions matter, surfacing blindspots, and writing down the shared understanding before building. It distinguishes facts, decisions, domain language, and unknowns to surface gaps prior to implementation.
Getting started
Install guidance is provided via folder placement and per-agent installation paths:
- Copy plugins/grill-for-unknowns into your agent's skills directory.
- Clone the repo:
git clone https://github.com/nicobailon/grill-for-unknowns.git /tmp/grill-for-unknowns
Claude Code:
mkdir -p ~/.claude/skills
cp -R /tmp/grill-for-unknowns/plugins/grill-for-unknowns ~/.claude/skills/grill-for-unknowns
Codex:
mkdir -p ~/.agents/skills
cp -R /tmp/grill-for-unknowns/plugins/grill-for-unknowns ~/.agents/skills/grill-for-unknowns
Hermes Agent:
mkdir -p ~/.hermes/skills/software-development
cp -R /tmp/grill-for-unknowns/plugins/grill-for-unknowns ~/.hermes/skills/software-development/grill-for-unknowns
Then load via /skill grill-for-unknowns.
Recent releases
RELEASES (latest 0):
- none
Traction
Stars: 177 Forks: 6 Open issues: 0 Created: 2026-07-09 Last push: 2026-07-10
License
MIT
What it contains
Package contents show a SKILL.md folder with templates and references, including ADRs, CONTEXT, grill-session, implementation-notes, and launch-packet templates, under plugins/grill-for-unknowns.
How this differs from upstream
The README explains five extensions to upstream skills: handling unknowns beyond known unknowns, defining good questions with a citation and rationale, self-contained design, extended post-alignment artifacts, and durable artifacts like ADRs and launch packets.