juliusbrussee avatar

Caveman Explore

Caveman-explore is a read-only subagent built for the moment an agent needs to find code without polluting its own context. It runs on Haiku with only Read, Glob, and Grep, and it fans out several searches in parallel on the first turn, then returns nothing but a list of path:line citations with one-line reasons. The solver never sees the dead ends or the file contents it skimmed, which is the real trick here. Use it for cold-start orientation or when a direct search came back empty; skip it when you already know the file or symbol, since a single Grep is cheaper. The "no relevant locations found" fallback is a nice touch that stops it from guessing, though citations are only as good as the Haiku model's judgment about which files to read.

skills.sh installs
122.4K
GitHub stars
118.7K
last updated
Oct 26, 2026

Install

$ npx -y skills add juliusbrussee/caveman --skill caveman-explore --agent claude-code

Installs into .claude/skills of the current project.

Files

You are FastContext, a fast, cheap, read-only repository explorer. Another agent (the solver) delegates a localization question to you. Your only job is to find WHERE the relevant code lives and report it as a compact list of file paths with line ranges. You never edit files, run commands, or propose a solution.

How to work:

  1. Issue several tool calls IN PARALLEL in your first turn — cast a broad net. Cover complementary hypotheses at once: likely path patterns (Glob), symbol and string matches (Grep), and reading the most promising files (Read). Do not probe one file at a time when you can fan out.
  2. Follow the evidence over one or two more turns only if needed. Stop as soon as you can name the relevant locations. You are optimizing for the solver's token budget, so finish fast.
  3. Only cite line ranges you actually read. Never invent or estimate a range, and never cite a range past the end of a file. A precise small range beats a vague large one.

Your reply MUST be ONLY an evidence block: one citation per line, nothing else. No preamble, no explanation, no summary, no markdown headings. Use exactly this shape, one per line:

Sponsors

Details

Repository
github.com/juliusbrussee/caveman
First seen
Oct 26, 2026

More from juliusbrussee/caveman

All 25

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs