documentationby fradser

Grill With Docs

fradser/grill-with-docs

Source fradser/dotclaude ↗License MIT

Runs a relentless interview that sharpens a plan or design and creates docs (ADRs and glossary) along the way.

NewMaintained

On-demandOn-demand: invoked explicitly — never occupies your agent's context until called.

Coding pack

Last verified 8/29/2026

What it changes

Passed 1 of 8 test cases with the skill, and 1 of 8 without it.

Without skill14%

With skill9%

0 fixed2 passed either way19 still failing1 broke

Pass-rate lift: -5 pp
Tokens: +101%
Agent turns: 0%
Response time: +124%

Model gemini-3.6-flashMeasured 8/29/2026v1 · latest is v22 of 22 cases passed with skill · 8 comparable

Tokens, turns and time describe resource use, not a dollar price.

This benchmark measured an earlier version of the skill.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/fradser-grill-with-docs/SKILL.md https://app.decimal.ai/s/fradser-grill-with-docs/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add fradser-grill-with-docs, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/fradser-grill-with-docs/ and pins it in .decimal/skills.lock

decimalai skills add fradser-grill-with-docs

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/fradser-grill-with-docs/SKILL.md https://app.decimal.ai/s/fradser-grill-with-docs/SKILL.md

Raw file: /s/fradser-grill-with-docs/SKILL.md ↗ · machine-readable summary at /s/fradser-grill-with-docs.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

What's inside

The instructions your model reads when the skill loads.

SKILL.md5 linessingle file

Call the Skill tool twice, for "mattpocock:grilling" and "mattpocock:domain-modeling".

CRITICAL: Grill with the docs skills loaded

Run the /mattpocock:grilling session with the /mattpocock:domain-modeling skill active. Every sharpened term and locked decision lands in CONTEXT.md or an ADR as it crystallises — the paper trail is what distinguishes this skill from /mattpocock:grill-me. Interview questions go through the AskUserQuestion tool, one per call, as /mattpocock:grilling dictates.

Track record

Benchmark

1 / 8

test cases passed, vs 1 / 8 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 9/25/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

fradser / dotclaude

mattpocock/skills/engineering/grill-with-docs/SKILL.md

View on GitHub ↗

License MITImported 9/25/2026Version v2

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

More skills from the same source and nearby in the registry, with their headline benchmark lift.

sickn33/grillingInterview the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.Close match+68 pp pass-rate lift

fradser/improve-codebase-architectureScans a codebase for deepening opportunities, presents them as a visual HTML report, then grills through the chosen one. Use when the user wants to improve codebase architecture or find refactoring opportunities.

fradser/initInitializes or optimizes git-agent configuration, regenerates commit scopes from git history, and re-derives .gitignore rules.+45 pp pass-rate lift

fradser/larkLark/Feishu CLI router: match intent, then Read the Entry file under lark-*/ (e.g. lark-doc/lark-doc.md). Covers docs, markdown, sheets, base, calendar, im, mail, task, okr, drive, wiki, slides, whiteboard, apps, approval, attendance, contact, vc, minutes, note, event via lark-cli. Use when operating Feishu/Lark workspace resources, messaging, docs, calendars, tasks, OKRs, or Miaoda deploys.

fradser/loop-meRuns a stateful grilling session that produces workflow specs for workflows the user wants to build. Use when the user says "loop me" or wants workflow specs drawn out of them.-13 pp pass-rate lift

fradser/marketingMarketing skills router: match marketing intent to a sub-skill, then Read its Entry file under skills/<name>/ (e.g. ads/ads.md). Covers CRO, copywriting, SEO/AEO, paid ads, ad creative, analytics, email/SMS, pricing, launches, video/image generation, and growth loops. Use for any marketing request — campaigns, content, optimization, measurement.0 pp pass-rate lift