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.
Install
/plugin marketplace add nicobailon/grill-for-unknownsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add nicobailon/grill-for-unknowns --skill grill-for-unknownsgit 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-unknownsPersonal 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.
Details
- Skill name
grill-for-unknowns- Repository
- nicobailon/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
514Dokhacgiakhoa/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.
Geo Content Optimizer
241liangdabiao/GEO-Content-Optimizer-Skill
AI 驱动的网页内容优化分析工具。输入 URL,自动抓取页面标题,通过 Google 搜索进行查询扩展, 获取 Google AI 概览,对比有机搜索覆盖与 AI 生成概览,生成中文优化建议报告。 当用户说"优化这个页面"、"分析这个网址"、"GEO 分析"、"内容优化"、"geo分析"或提供 URL 并要求内容改进建议时触发。
Dspy Evaluation Harness
280intertwine/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.
Triage
211iamyoki/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.
Internal Comms
193MavCui/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.).
Lessons Record
559KunoLu/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.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.