Skip to content
Back to search

grill-for-unknowns

Agent skill for finding unknowns, grilling plans, and reaching shared understanding before implementation

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nicobailon--grill-for-unknowns/badge.svg)](/listings/nicobailon--grill-for-unknowns)

HTML

<a href="/listings/nicobailon--grill-for-unknowns"><img src="/api/listings/nicobailon--grill-for-unknowns/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code (recommended: plugin marketplace)

/plugin marketplace add nicobailon/grill-for-unknowns
/plugin install grill-for-unknowns@grill-for-unknowns-marketplace

Invoke it as `/grill-for-unknowns` or let it trigger from the description. Update later with:

/plugin update grill-for-unknowns

Prefer a manual install? Copy the folder instead:

git clone 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

For a project-scoped install, copy into `.claude/skills/` inside the repo instead.

Codex and Hermes (recommended: clone + symlink)

Clone once to a stable location, then symlink into each agent's skills directory — updating every agent later is a single `git pull`:

git clone https://github.com/nicobailon/grill-for-unknowns.git ~/.local/share/grill-for-unknowns
SKILL_SRC=~/.local/share/grill-for-unknowns/plugins/grill-for-unknowns

# Codex
mkdir -p ~/.agents/skills
ln -s "$SKILL_SRC" ~/.agents/skills/grill-for-unknowns

# Hermes
mkdir -p ~/.hermes/skills/software-development
ln -s "$SKILL_SRC" ~/.hermes/skills/software-development/grill-for-unknowns

If you prefer a plain copy, replace `ln -s` with `cp -R` (and re-copy to update).

Codex picks up skills from `~/.agents/skills` (personal) or `.agents/skills` inside a repo (project-scoped); invoke with `$grill-for-unknowns` or let implicit matching select it from the description. See the [Codex skills docs](https://learn.chatgpt.com/docs/build-skills).

For Hermes, start a fresh session or reload skills, then load it explicitly when needed:

/skill grill-for-unknowns

Other agents

Any agent that supports `SKILL.md` skill folders can use the same clone-and-symlink (or copy-the-folder) approach.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 39 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "grill-for-unknowns-marketplace",
  3. "owner": {
  4. "name": "nicobailon"
  5. },
  6. "metadata": {
  7. "description": "Plugin distribution for grill-for-unknowns",
  8. "version": "0.1.3",
  9. "pluginRoot": "./plugins"
  10. },
  11. "plugins": [
  12. {
  13. "name": "grill-for-unknowns",
  14. "source": "./plugins/grill-for-unknowns",
  15. "description": "Docs-grounded grilling, unknown discovery, and shared understanding before implementation",
  16. "version": "0.1.3",
  17. "author": {
  18. "name": "Nico Bailon (co-authored by Matt Pocock)"
  19. },
  20. "repository": "https://github.com/nicobailon/grill-for-unknowns",
  21. "license": "MIT",
  22. "keywords": [
  23. "planning",
  24. "unknowns",
  25. "grilling",
  26. "domain-modeling",
  27. "interviews"
  28. ],
  29. "category": "engineering",
  30. "tags": [
  31. "planning",
  32. "docs",
  33. "unknowns",
  34. "agentic-coding",
  35. "verification"
  36. ]
  37. }
  38. ]
  39. }
README.md · README · 171 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # grill-for-unknowns
  2. **An agent skill for finding unknowns, grilling plans, and reaching shared understanding before implementation.**
  3. `grill-for-unknowns` combines docs/source-grounded plan interrogation with the “finding your unknowns” strategy: known knowns, known unknowns, unknown knowns, and unknown unknowns.
  4. The intended behavior is simple:
  5. > Inspect the real territory first, grill the plan and user only where decisions matter, surface blindspots, write down the shared understanding, then build.
  6. ## What it does
  7. Use this skill when an agent should **not** rush straight into implementation:
  8. - unfamiliar codebase area,
  9. - unfamiliar API/library/platform docs,
  10. - vague product/design direction,
  11. - long-running subagent or coding-agent launch,
  12. - complex architecture or domain-model decision,
  13. - failed previous attempt due to assumptions,
  14. - or any plan that needs to be pressure-tested before building.
  15. The skill asks the agent to separate:
  16. - **facts** it can discover from docs/source/tests/config,
  17. - **decisions** it needs the user to make,
  18. - **domain language** that should be clarified and recorded,
  19. - and **unknowns** that could materially change implementation.
  20. ## Install
  21. ### Claude Code (recommended: plugin marketplace)
  22. ```txt
  23. /plugin marketplace add nicobailon/grill-for-unknowns
  24. /plugin install grill-for-unknowns@grill-for-unknowns-marketplace
  25. ```
  26. Invoke it as `/grill-for-unknowns` or let it trigger from the description. Update later with:
  27. ```txt
  28. /plugin update grill-for-unknowns
  29. ```
  30. Prefer a manual install? Copy the folder instead:
  31. ```bash
  32. git clone https://github.com/nicobailon/grill-for-unknowns.git /tmp/grill-for-unknowns
  33. mkdir -p ~/.claude/skills
  34. cp -R /tmp/grill-for-unknowns/plugins/grill-for-unknowns ~/.claude/skills/grill-for-unknowns
  35. ```
  36. For a project-scoped install, copy into `.claude/skills/` inside the repo instead.
  37. ### Codex and Hermes (recommended: clone + symlink)
  38. Clone once to a stable location, then symlink into each agent's skills directory — updating every agent later is a single `git pull`:
  39. ```bash
  40. git clone https://github.com/nicobailon/grill-for-unknowns.git ~/.local/share/grill-for-unknowns
  41. SKILL_SRC=~/.local/share/grill-for-unknowns/plugins/grill-for-unknowns
  42. # Codex
  43. mkdir -p ~/.agents/skills
  44. ln -s "$SKILL_SRC" ~/.agents/skills/grill-for-unknowns
  45. # Hermes
  46. mkdir -p ~/.hermes/skills/software-development
  47. ln -s "$SKILL_SRC" ~/.hermes/skills/software-development/grill-for-unknowns
  48. ```
  49. If you prefer a plain copy, replace `ln -s` with `cp -R` (and re-copy to update).
  50. Codex picks up skills from `~/.agents/skills` (personal) or `.agents/skills` inside a repo (project-scoped); invoke with `$grill-for-unknowns` or let implicit matching select it from the description. See the [Codex skills docs](https://learn.chatgpt.com/docs/build-skills).
  51. For Hermes, start a fresh session or reload skills, then load it explicitly when needed:
  52. ```txt
  53. /skill grill-for-unknowns
  54. ```
  55. ### Other agents
  56. Any agent that supports `SKILL.md` skill folders can use the same clone-and-symlink (or copy-the-folder) approach.
  57. ## Updating
  58. - **Claude Code (marketplace install)** — `/plugin update grill-for-unknowns`, then restart the session.
  59. - **Symlink installs** — `git -C ~/.local/share/grill-for-unknowns pull` updates every symlinked agent at once.
  60. - **Copied installs** — re-run the copy command from the install section.
  61. Releases are tagged and listed at [Releases](https://github.com/nicobailon/grill-for-unknowns/releases); see [`CHANGELOG.md`](CHANGELOG.md) for what changed.
  62. ## Example prompts
  63. ```txt
  64. Use grill-for-unknowns before implementing this. Inspect the relevant docs/source first, then interview me one material question at a time until we have shared understanding.
  65. ```
  66. ```txt
  67. Grill this plan against the codebase and official docs. Do not build yet. Surface unknown unknowns, challenge domain terms, and produce a launch packet.
  68. ```
  69. ```txt
  70. I know what I want when I see it. Use grill-for-unknowns to prototype options and extract my unknown knowns before implementation.
  71. ```
  72. ```txt
  73. Before spawning subagents, use grill-for-unknowns to turn this fuzzy request into a clear launch packet with assumptions, open questions, verification steps, and rollback risks.
  74. ```
  75. ## Package contents
  76. ```txt
  77. grill-for-unknowns/
  78. ├── README.md
  79. ├── CHANGELOG.md
  80. ├── LICENSE
  81. ├── NOTICE.md
  82. ├── package.json
  83. ├── .claude-plugin/
  84. │ └── marketplace.json
  85. └── plugins/
  86. └── grill-for-unknowns/
  87. ├── SKILL.md
  88. ├── README.md
  89. ├── LICENSE
  90. ├── .claude-plugin/
  91. │ └── plugin.json
  92. ├── references/
  93. │ ├── upstream-lineage.md
  94. │ └── domain-modeling-add-on.md
  95. └── templates/
  96. ├── ADR.md
  97. ├── CONTEXT.md
  98. ├── grill-session.md
  99. ├── implementation-notes.md
  100. └── launch-packet.md
  101. ```
  102. ## Credits and lineage
  103. This skill is substantially inspired by, and should be treated as an adaptation/fork of, Matt Pocock’s skill composition around `grill-with-docs`:
  104. - Matt Pocock’s `grill-with-docs` skill:
  105. https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md
  106. - Matt Pocock’s `domain-modeling` skill:
  107. https://github.com/mattpocock/skills/tree/main/skills/engineering/domain-modeling
  108. - Matt Pocock’s `grilling` skill:
  109. https://github.com/mattpocock/skills/blob/main/skills/productivity/grilling/SKILL.md
  110. Additional inspiration comes from Thariq’s X article:
  111. - Thariq, “A Field Guide to Fable: Finding Your Unknowns”:
  112. https://x.com/trq212/status/2073100352921215386
  113. ## How this differs from the upstream skills
  114. The upstream skills are deliberately minimal and compositional: `grilling` is a ~10-line relentless-interview loop, and `grill-with-docs` composes it with `domain-modeling`. `grill-for-unknowns` keeps that core loop and expands it in five ways:
  115. 1. **It covers gaps an interview can't see.** The upstream loop only handles known unknowns — questions someone already knows to ask. The four-quadrant taxonomy adds explicit tactics for unknown knowns (the user's unverbalized taste, extracted through cheap prototypes and contrasting references instead of questions the user can't answer) and unknown unknowns (a blindspot pass over docs/source/tests before the interview starts).
  116. 2. **It defines what a good question is.** "Relentless" is a personality, not a quality bar. Here every question must be material, grounded in evidence, and answerable, using a template that forces a citation, a why-it-matters, and a recommended default. Low-risk unknowns become labeled assumptions instead of questions at all.
  117. 3. **It is self-contained.** `grill-with-docs` silently depends on two other skills being installed; an agent that loads only the headline file gets almost nothing. This skill inlines the grilling loop and the domain-modeling rules, so it works dropped into any agent — Hermes, Claude Code, or Codex.
  118. 4. **It extends past the planning boundary.** Upstream ends at "don't build until shared understanding is confirmed." This skill covers what happens after alignment: a launch packet for subagents and long-running coding agents, a deviation policy (continue-and-log vs. stop-and-ask), implementation notes for newly discovered unknowns, and a post-implementation explainer/quiz.
  119. 5. **It produces durable artifacts.** Session ledgers, launch packets, implementation notes, `CONTEXT.md`, and ADRs give the shared understanding a reusable written shape instead of leaving it in the chat transcript.
  120. ## License
  121. MIT. See [`LICENSE`](LICENSE).
  122. The upstream `mattpocock/skills` repository is MIT licensed with copyright held by Matt Pocock. Because this skill is an adaptation/fork rather than a totally original work, the license preserves Matt Pocock’s MIT copyright notice and adds Nico Bailon’s copyright notice for this adaptation.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.