plan-sketch

plan-sketch is a skill for Claude Code from besimple-oss/broccoli. It costs 41 tokens per session (1,378 once invoked), scanned A, original, MIT.

A planning workflow that performs limited research, starting with official documentation, and writes a high-level implementation outline in a Markdown file. It also reports unresolved questions and assumptions in a structured format.

In plain words
What is it for?
Use it to create a preliminary plan in a repository, record implementation steps, identify unknowns, and ask for choices about architecture, APIs, rollout, testing, or migrations.
Why use it?
It helps settle the approach and order of work before coding begins. The questions expose decisions that could materially change the implementation plan.

Skill for Claude Code

Written for Claude Code: $ARGUMENTS substitution. Also seen: mentions subagents; positional $N argument; mentions Codex.

Good fit Use it to create a preliminary plan in a repository, record implementation steps, identify unknowns, and ask for choices about architecture, APIs, rollout, testing, or migrations.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/besimple-oss/broccoli/plan-sketch
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add besimple-oss/broccoli --skill plan-sketch
Clone the repo
git clone --depth 1 https://github.com/besimple-oss/broccoli

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for plan-sketch

README.md
[![agentmods](https://agentmods.dev/badge/skills/besimple-oss/broccoli/plan-sketch/github.svg)](https://agentmods.dev/skills/besimple-oss/broccoli/plan-sketch)
Your own site
<a href="https://agentmods.dev/skills/besimple-oss/broccoli/plan-sketch"><img src="https://agentmods.dev/badge/skills/besimple-oss/broccoli/plan-sketch/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for plan-sketch

Your own site · 80×15
<a href="https://agentmods.dev/skills/besimple-oss/broccoli/plan-sketch"><img src="https://agentmods.dev/badge/skills/besimple-oss/broccoli/plan-sketch.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,378 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00041 $0.01378
Opus 5 $0.00020 $0.00689
Sonnet 5 $0.00008 $0.00276
Haiku 4.5 $0.00004 $0.00138

Measured 9d ago against content hash 1f557f420fc7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

plan-sketch scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/run_plan_sketch.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

prompt-templates/skills/plan-sketch/SKILL.md · 118 lines

How it starts

The opening of the file, as written. The whole thing — 118 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Plan Sketch

Preconditions

  • Confirm you are in the intended repo: git rev-parse --show-toplevel
  • Confirm whether web browsing is allowed.
    • If browsing is blocked by sandbox/approvals, ask the user to enable/approve it.
    • If the user says "no web browsing", proceed but clearly label assumptions where "latest" matters.

Output contract (required)

plan-sketch must produce:

  1. A sketch markdown file (usually under sketch/, or an explicit --output path if provided).
  2. A small, parseable Questions for user block in the subagent's stdout output so wrapper skills can ask the user without reading the sketch content into context.
  3. A machine-readable JSON Questions block in stdout so wrapper skills can parse choices programmatically.

The Questions block must cover:

  • Any open questions / unknowns that change the plan materially.
  • Any assumptions that should be confirmed.
  • Any high-level approach forks (architecture, APIs, rollout/testing strategy, migrations).
  • If there are multiple viable implementation approaches, include an explicit choose an approach question so the user picks one before planning.

Format requirements (strict):

  • Do not print the sketch content in the response.
  • Print the sketch path (single line) and then print a Questions block bracketed by markers:
    • BEGIN_USER_QUESTIONS
    • END_USER_QUESTIONS
  • In the Questions block:
    • Start with a short instruction telling the user to answer in one batch by label/number.
    • Present all decision-steering questions at once.
    • Number questions as 1), 2), ... (not bullets).
    • For each question, include 2–4 mutually exclusive options.
    • Label options as 1a), 1b), 1c) ... (letters per question), and make the labels easy to copy/paste.
    • Put the recommended option first and include a 1-sentence rationale on the same line.
    • End the block with a single-line summary of recommended picks in the format:
      • Recommended picks (copy/paste): 1a, 2b, 3a
    • If there are no meaningful open questions, include at least 1 explicit confirmation question with options.
  • After the text Questions block, print a JSON Questions block bracketed by markers:
    • BEGIN_USER_QUESTIONS_JSON
    • END_USER_QUESTIONS_JSON
  • The JSON block must be valid JSON and include:
    • questions: array of objects with id (number or string) and options.
    • Each options entry includes label (e.g., 1a) and text.
    • Optional: recommended boolean on options and recommended_picks array at the top level.

Read the full file on GitHub · 118 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 118 lines · 41 tokens per session scan A 1f557f420fc7

Subscribe to this mod's changes

plan-sketch is a skill published in the GitHub repository besimple-oss/broccoli (285 stars, last pushed 4mo ago), licensed MIT. It adds 41 tokens to every session and 1,378 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

memory-onboard

Use this skill when the user types /memory-onboard (or asks "set up memory for this repo" / "onboard this repo to memory" / "what should be in lore for this repo?"). It runs a repo-aware onboarding interview that produces DRAFT lore records grounded in concrete repo signals (README, ADRs, recent commits, deprecation…

tmj-90/gaffer · 196 tokens

plan-build

Use to turn a one-line brief into a phased, dependency-ordered epic of small, well-specified, deliverable tickets — covering BOTH "build me an app that does X from scratch" (greenfield) and "change/extend/redesign an existing app X" (brownfield, when a target repo is supplied). Clarify genuine ambiguity first, draft…

tmj-90/gaffer · 144 tokens

design-system

Use when a ticket needs a systematic token + component foundation for a frontend — the three-layer token architecture (primitive → semantic → component), component specs with full state coverage, or a recommendation for which design system a product should have. Invoke for "set up design tokens", "define the component…

tmj-90/gaffer · 106 tokens

spec-author

Use to turn a brief into a structured product SPEC — a set of testable CLAUSES, each exactly one statement, tagged requirement / non-goal / decision — that a human edits and freezes before it feeds the decompose engine. Clarify genuine load-bearing ambiguity first, then draft. Invoke whenever someone describes an app…

tmj-90/gaffer · 117 tokens

brand

Use to establish or audit a product's brand so the factory's output looks intentional, not template — when a ticket asks to "create a brand", "define the design system / visual identity / palette / typography", or when delivered UI looks generic and needs a deliberate direction. Detects existing brand and extends it…

tmj-90/gaffer · 102 tokens

code-tour

Use when asked to create a code walkthrough, onboarding tour, architecture tour, PR review tour, or any structured explanation of how a codebase works. Triggers on "create a code tour", "onboarding tour", "how does X work", "explain the codebase", "architecture walkthrough", "PR tour", or "contributor guide". Outputs…

tmj-90/gaffer · 102 tokens