Agent skill

Grill With Docs

by PromptPartner in PromptPartner/agentsmith

Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan.

MITAuto-check passedTesting & QA

Install Grill With Docs

skills CLI
$ npx skills add PromptPartner/agentsmith --skill grill-with-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PromptPartner/agentsmith grill-with-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PromptPartner/agentsmith.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/grill-with-docs .claude/skills/grill-with-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
grill-with-docs
GitHub stars
177
Token cost
~960 tokens
SKILL.md length
478 words
Files
3
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan.

  • Works in 3 steps: Read the tracked item, existing… → Locate the project's plan convention.… → Map the unresolved choices as a design…
  • The operator asks to grill
  • SKILL.md covers Route, Establish the tree, Work the frontier and Durable artifacts, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Grill With Docs is an agent skill from PromptPartner/agentsmith. Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan. Use when the operator asks to grill or stress-test a plan or design in a repository; route multi-session uncertainty to wayfinder.

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `ADR-FORMAT.md` and `CONTEXT-FORMAT.md`). Compatibility notes: Requires an Agent Skills-compatible coding agent with filesystem access.

It sits in Testing & QA, covering Load testing. The repository describes itself as: Universal, model-agnostic operating harness for AI agents (Claude, Codex, Gemini, …) — a lean core + work-type profiles assembled by one setup script. The licence is MIT.

When your agent uses it

  • The operator asks to grill
  • Stress-test a plan
  • Design in a repository
  • Route multi-session uncertainty to wayfinder

Example prompts

  • “/grill-with-docs”

Requirements

  • Compatibility (from SKILL.md): Requires an Agent Skills-compatible coding agent with filesystem access.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read the tracked item, existing plan/spec, CONTEXT-MAP.md, relevant CONTEXT.md files, ADRs,
  2. Locate the project's plan convention. Reuse an existing change plan; otherwise create one from
  3. Map the unresolved choices as a design tree. Its frontier is the independent questions whose

What it can do on your machine

Read from SKILL.md and the folder at commit b293c3a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires an Agent Skills-compatible coding agent with filesystem access.

    From compatibility in the SKILL.md frontmatter.

Context cost

Grill With Docs loads about 960 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 478 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~960

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from PromptPartner/agentsmith at commit b293c3a, republished under its MIT licence (© PromptPartner). 478 words, ~960 tokens.

Download SKILL.mdSave it as .claude/skills/grill-with-docs/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
grill-with-docs
description
Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan. Use when the operator asks to grill or stress-test a plan or design in a repository; route multi-session uncertainty to wayfinder.
compatibility
Requires an Agent Skills-compatible coding agent with filesystem access.

Grill with docs

Resolve a change's design tree with the operator while recording each answer where a fresh session can use it. Stop at a handoff-ready plan; implementation is a separate unit of work.

Route

  • Use this workflow when a repository change is fuzzy but can be settled in one session.
  • Use wayfinder when the destination spans sessions, has dependent decisions that need separate research, or cannot yet become one implementation plan.
  • Use the ordinary plan flow when scope, language, and consequential choices are already settled.

Establish the tree

  1. Read the tracked item, existing plan/spec, CONTEXT-MAP.md, relevant CONTEXT.md files, ADRs, and the code or assets that constrain the change. Facts come from the repository; decisions come from the operator.
  2. Locate the project's plan convention. Reuse an existing change plan; otherwise create one from .harness/templates/plan.md, templates/plan.md, or the same shape at .planning/<slug>.md, in that order of availability.
  3. Map the unresolved choices as a design tree. Its frontier is the independent questions whose prerequisites are settled now.

Work the frontier

Ask a small numbered round from the frontier. For each question, state why it matters, the real options and trade-offs, and your recommended answer. Then wait for the operator's decisions.

After each answer round:

  1. Recompute the tree. Cross-check claims against the repository and surface contradictions.
  2. Record every settled decision in the plan with its original precision: boundaries, ordering, defaults, failure behaviour, numeric constraints, and evidence requirements.
  3. Record resolved project language and qualifying ADRs before the next question round.

Repeat until the frontier is empty. A question that depends on an unresolved answer stays off the current frontier.

Durable artifacts

Show full SKILL.md (205 more words)Show less
Plan

The plan is the complete decision ledger and implementation handoff. Keep its scope, approach, risks, verification, and done criteria current after each round. Place rationale once: in the plan for ordinary choices, or in an ADR for a qualifying architectural choice with a link from the plan.

Project language

When a project-specific term resolves, update the relevant CONTEXT.md immediately using CONTEXT-FORMAT.md. A root CONTEXT-MAP.md selects the bounded context; without one, use the root glossary. Create the file lazily on the first qualifying term.

Architectural decisions

Create an ADR only when the choice passes all three gates in ADR-FORMAT.md: hard to reverse, surprising without context, and the result of a real trade-off. Create docs/adr/ lazily and preserve the repository's existing ADR convention when one exists.

Completion

Offer the plan for confirmation only when the frontier is empty, every settled decision is durable, repository contradictions are resolved or explicit, and the plan defines end-to-end evidence. The session completes when the operator confirms shared understanding. Report the plan path, glossary and ADR changes, and whether the next route is implementation or wayfinder.


Adapted from Matt Pocock's grilling, domain-modeling, and grill-with-docs skills (MIT, 2026). AgentSmith makes the workflow self-contained and keeps every settled decision in the repository plan.

© PromptPartner, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in skills/grill-with-docs of PromptPartner/agentsmith.

  • SKILL.md
  • ADR-FORMAT.md
  • CONTEXT-FORMAT.md

Open the folder on GitHubat commit b293c3a

Compare with similar skills

Grill With Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Grill With Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Grill With Docs this skillPromptPartner/agentsmith177—~960Automated safety check: PassMIT
Writing Livekit Scenarioslivekit-examples/agent-starter-python2641 repos~2.5kAutomated safety check: PassMIT
Go Testingcxuu/golang-skills1701 repos~1.3kAutomated safety check: PassApache-2.0
Goalcraftgrp06/goalcraft102—~3.8kAutomated safety check: PassMIT
Thinking Partnermattnowdev/thinking-partner206—~4.4kAutomated safety check: PassMIT
Visionkunchenguid/vision329—~2.9kAutomated safety check: PassMIT

Similar skills

  • Writing Livekit Scenarios

    livekit-examples/agent-starter-python

    Creates and maintains the scenarios a LiveKit agent simulation runs, and wires the agent to consume them.

    264 GitHub starsUsed in 1 repo~2.5k tokens
    Testing & QAAuto-check passed
  • Go Testing

    cxuu/golang-skills

    A skill your agent uses when writing, reviewing, or improving Go test code — including table-driven tests, subtests, parallel tests, test helpers, test doubles, and assertions with cmp.Diff.

    170 GitHub starsUsed in 1 repo~1.3k tokens
    Testing & QAAuto-check passed
  • Goalcraft

    grp06/goalcraft

    Turn a rough draft, vague ambition, or messy task brief into a powerful Codex /goal objective for persistent, evidence-checked work.

    102 GitHub stars~3.8k tokensUpdated 4 mo ago
    Testing & QAAuto-check passed
  • Thinking Partner

    mattnowdev/thinking-partner

    A deterministic thinking partner that challenges assumptions and applies mental models to sharpen decisions, solve problems, and think more clearly.

    206 GitHub stars~4.4k tokensUpdated 6 mo ago
    Testing & QAAuto-check passed
  • Vision

    kunchenguid/vision

    Draft and stress-test a VISION.md for a repository, then iterate with the author on an interactive review board until approved.

    329 GitHub stars~2.9k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Volt Load Testing

    owenHochwald/volt

    Safely exercise and evaluate HTTP APIs with the Volt CLI, including authenticated requests, JSON bodies, staged load, machine-readable results, performance baselines, and before/after comparisons.

    141 GitHub stars~1.2k tokensUpdated 2 mo ago
    Testing & QAAuto-check passed

More from PromptPartner/agentsmith

All 10 skills in this repo
  • Autonomous Run

    PromptPartner/agentsmith

    Prepare, start, inspect, resume, or stop a finite local overnight coding run after a human has accepted a Wayfinder terminal spec; coordinates a declared Claude/Codex maker and independent checker…

    177 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Wayfinder

    PromptPartner/agentsmith

    Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts.

    177 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Handoff

    PromptPartner/agentsmith

    Checkpoint work for recovery — fires on "handoff", "wrap up", context pressure, a closed phase, or before a long external wait or irreversible gate.

    177 GitHub stars~702 tokensUpdated yesterday
    Auto-check passed
  • Harness Doctor

    PromptPartner/agentsmith

    Check whether this project's Agentsmith harness is installed correctly and healthy — fires on "is my harness set up right?", "harness doctor", "check my harness".

    177 GitHub stars~845 tokensUpdated yesterday
    Auto-check passed
  • Harness Help

    PromptPartner/agentsmith

    Orient a non-coder to this project's Agentsmith harness — fires on "what is this harness?", "what are my rules?", "which profile am I on?", "what do I type next?".

    177 GitHub stars~568 tokensUpdated yesterday
    Auto-check passed
  • New Feedback

    PromptPartner/agentsmith

    Log a harness lesson / post-incident so the SYSTEM improves, not just this one bug — fires on "log a harness lesson", "post-incident", "we should make this less likely", System-Evolution moments.

    177 GitHub stars~608 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Grill With Docs

What does Grill With Docs do?

Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan. Grill With Docs is an agent skill from PromptPartner/agentsmith. Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan.

When should I use Grill With Docs?

Grill With Docs fits situations like: the operator asks to grill; stress-test a plan; design in a repository; route multi-session uncertainty to wayfinder.

How do I install Grill With Docs in Claude Code?

Run `npx skills add PromptPartner/agentsmith --skill grill-with-docs -a claude-code`. Or copy the skill folder (skills/grill-with-docs in PromptPartner/agentsmith) into .claude/skills/grill-with-docs in your project. Claude Code loads it when a task matches its description.

How do I install Grill With Docs in Codex?

Run `npx skills add PromptPartner/agentsmith --skill grill-with-docs -a codex`. Or copy the skill folder (skills/grill-with-docs in PromptPartner/agentsmith) into .agents/skills/grill-with-docs in your project. Codex loads it when a task matches its description.

Can I use Grill With Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PromptPartner/agentsmith --skill grill-with-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/grill-with-docs, .gemini/skills/grill-with-docs, .github/skills/grill-with-docs and .opencode/skills/grill-with-docs in your project.

What does Grill With Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Grill With Docs is instructions for the agent only. Compatibility (from SKILL.md): Requires an Agent Skills-compatible coding agent with filesystem access..

Does Grill With Docs access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Grill With Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Grill With Docs use?

Grill With Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Grill With Docs use?

About 960 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Grill With Docs?

Skills that share tags, products or a category with Grill With Docs: Writing Livekit Scenarios (livekit-examples/agent-starter-python, 264 stars), Go Testing (cxuu/golang-skills, 170 stars), Goalcraft (grp06/goalcraft, 102 stars) and Thinking Partner (mattnowdev/thinking-partner, 206 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Grill With Docs?

PromptPartner (a GitHub user) maintains it in PromptPartner/agentsmith, which has 177 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

Source: PromptPartner/agentsmith on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.