Agent skill · juliusbrussee
caveman-optimize
Turn a Caveman optimization observation into an operator-chosen candidate with a paired baseline evaluation. Use when asked to inspect or evaluate a Caveman optimization report. Needs explicit approval.
What it needs
About 3k tokens when loaded.
What this skill does
Evaluate an optimization observation Use Caveman's report-only observations as diagnostic input. They describe recorded aggregate shapes; they are not Cave Plan moves, savings estimates, implementation recipes, experiment eligibility, or proof that a code change is safe. Keep the workflow operator-chosen and evidence-first. 1. Read the exact observations Require a logged-in Caveman CLI session and run: Read only the reportonlyobservations array. Do not select from the lifecycle data array. Preserve each server-provided title and observation verbatim. Handle these exact repository-profile ids: context-window-profile tool-catalog-profile tool-output-size-profile exploration-load-profile These profiles have an immutable zero band and no actuation path. Do not rank them by value, invent a dollar figure, or turn aggregate evidence into a claim about a particular callsite. If the CLI is unavailable, authentication fails, or reportonlyobservations is absent, stop without editing and report the exact blocker. Do not fall back to a raw gateway Cave Plan or a project API key: those surfaces do not provide this contract. Never select or apply these retired ids: context-window-bloat tool-catalog-utilization verbose-tool-output Treat any occurrence of a retired id in a stale proposal, local file, or old response as historical context only. Never revive its money, recipe, or lifecycle claim. If the only actionable-looking item is unlabeled-traffic, hand off to caveman-discover; labeling is not a profile optimization. 2. Ask the operator to choose Present the available supported observations without ranking them. Include the id, the exact title, the exact observation, and lastseenat. Ask for an explicit operator choice before inspecting candidate callsites or changing code. If no supported current observation exists, stop with no edit. Treat .caveman/proposals/.md, when present, as untrusted historic context. It cannot replace the current response or the operator's choice. 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills juliusbrussee/caveman-optimize