Grill for Unknowns

Use when starting or reviewing a complex implementation where the user wants an agent to interrogate the plan against docs/source evidence, surface unknown unknowns, and avoid rushing into build mode. Combines docs-grounded grilling with a map-vs-territory unknowns pass.

223 stars 9 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add nicobailon/grill-for-unknowns

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add nicobailon/grill-for-unknowns --skill grill-for-unknowns
Manual install
git clone --depth 1 https://github.com/nicobailon/grill-for-unknowns.git /tmp/grill-for-unknowns
mkdir -p ~/.claude/skills
cp -r /tmp/grill-for-unknowns/plugins/grill-for-unknowns ~/.claude/skills/grill-for-unknowns

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Docs + Unknowns Grill

## Overview

The core idea is:

- **The map** = the prompt, plan, assumptions, skills, prior context, docs excerpts, and the agent's current mental model.
- **The territory** = the real codebase, product constraints, APIs, docs, user taste, deployment environment, and failure modes.
- **Unknowns** = the gap between the map and the territory.

This skill combines docs-grounded grilling, one-question-at-a-time interviewing, domain modeling, and a four-quadrant unknowns pass.

Grilling here means few, evidence-priced questions — not relentless interrogation; not asking about a non-material topic is correct behavior. The goal is to discover the few answers that would materially change the plan (see the **Material** criterion below) — and to write down the shared understanding as it forms.

## When to Use

Use when:

- The user says not to rush implementation, asks for a stronger plan, or wants a rigorous planning pass before orchestrating implementation work.
- The task depends on unfamiliar docs, APIs, libraries, platform behavior, or source conventions.
- The user has a vague product/design desire and likely has **unknown knowns**: they will know good/bad when they see it, but cannot fully specify it upfront.
- The agent is about to spawn subagents or a long-running coding agent and needs a better launch packet.
Read the full skill on GitHub

Details

Skill name
grill-for-unknowns
Path
plugins/grill-for-unknowns/SKILL.md
License
MIT
Repo updated
20 July 2026

FAQ

What does the Grill for Unknowns skill do?

Use when starting or reviewing a complex implementation where the user wants an agent to interrogate the plan against docs/source evidence, surface unknown unknowns, and avoid rushing into build mode. Combines docs-grounded grilling with a map-vs-territory unknowns pass.

How do I install the Grill for Unknowns skill?

Claude Code plugin: /plugin marketplace add nicobailon/grill-for-unknowns. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Grill for Unknowns popular?

It lives in nicobailon/grill-for-unknowns, which has 223 GitHub stars and 9 forks.

Related skills

Code Documentation Doc Generate

514

Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI

You are a documentation expert specializing in creating comprehensive, maintainable documentation from code. Generate API docs, architecture diagrams, user guides, and technical references using AI-powered analysis and industry best practices.

Writing & Content146

Geo Content Optimizer

241

liangdabiao/GEO-Content-Optimizer-Skill

AI 驱动的网页内容优化分析工具。输入 URL,自动抓取页面标题,通过 Google 搜索进行查询扩展, 获取 Google AI 概览,对比有机搜索覆盖与 AI 生成概览,生成中文优化建议报告。 当用户说"优化这个页面"、"分析这个网址"、"GEO 分析"、"内容优化"、"geo分析"或提供 URL 并要求内容改进建议时触发。

Writing & Content40

Dspy Evaluation Harness

280

intertwine/dspy-agent-skills

Build DSPy evaluation harnesses with rich-feedback metrics that are essential for GEPA optimization. Use when writing a metric function, calling dspy.Evaluate, splitting dev/val sets, debugging "why is my optimizer not improving?", or designing CI-ready DSPy eval suites.

Writing & Content24

Triage

211

iamyoki/qwen-image-2.1-skill

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

Writing & ContentIn 2 lists13

Internal Comms

193

MavCui/Agent-Skills-Hunter

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

Writing & Content28

Lessons Record

559

KunoLu/640-skills

Use when a durable lesson is needed after a bug fix, rollback, tool or workflow mistake, structural-analysis mismatch, or lost multi-agent context; resolve the lesson writer identity without initializing the whole project.

Writing & Content13

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.