grill-with-docs
An agent skill by mattpocock, from mattpocock/skills. Tags: brainstorming, documentation, planning, review, strategy.
What it does
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add mattpocock/skills --skill grill-with-docsOr copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/mattpocock/skills
cp -r skills/skills/engineering/grill-with-docs ~/.claude/skills/grill-with-docsSafety box score
Grade A, minimal risk: 4 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill is a documentation workflow: it runs a design interview and writes ADRs/glossary entries as it goes. It does not ship scripts, access networks, or touch secrets; the main effect is limited edits in the working tree while generating docs.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 0 (none) | No shell commands, code execution, or shipped scripts are present in `SKILL.md` or `agents/openai.yaml`. |
| Network access | 0 (none) | There is no download, API call, or outbound data flow described in the files. |
| Filesystem reach | 1 (low) | The skill explicitly says it "also creates docs (ADR's and glossary) as we go," so it may write files in the repo, but nothing suggests it goes outside the project. |
| Secrets & credentials | 0 (none) | No tokens, keys, passwords, `.env` files, or credential stores are mentioned. |
| Privilege & persistence | 0 (none) | No sudo, global install, service registration, or shell/OS setting changes are requested. |
| Instruction hijack surface | 0 (none) | There is no instruction to ignore safeguards, hide behavior, or follow remote instructions; the files are short and self-contained. |
| Irreversible actions | 0 (none) | The skill is for analysis and documentation only; it does not publish, deploy, send messages, or delete anything. |
| Transparency | 0 (none) | All shipped content is plain text YAML/Markdown; there are no binaries, blobs, or generated installers. |
Before installing
- Confirm you want a skill that may add or edit ADR and glossary files in the repo.
- If you keep docs in a specific path, check that this skill’s output matches your project layout before using it.
Rated 2026-10-20 by an automated review of 2 files from the skill's repository.
Source
- Repository
- mattpocock/skills (all skills from this repository)
- Path
- skills/engineering/grill-with-docs/SKILL.md
- Branch
- main
- Updated
- 2026-10-05
Related skills
- claude-md-progressive-disclosurer — Optimize, slim, or restructure CLAUDE.md/AGENTS.md with progressive disclosure and zero information loss. Use when the user explicitly asks to audit, 精简, 瘦身.
- goal-prompt — Drafts copy-paste-ready /goal commands for goal mode in Claude Code and Codex.
- marketing-ideas — When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product.
- marketing-plan — When the user needs a comprehensive marketing plan for a client, a company they advise, or their own product.
- principle-attack-the-premise — Apply when two or more fixes that share one premise have failed the same gate.
- seo-flow — FLOW framework integration: evidence-led SEO using the Find → Leverage → Optimize → Win loop.