Skip to content
alyn
JuliusBrussee

Caveman Explore skill

Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the exact file or symbol is already named. Returns path:line citations only; its reads stay out of main context.

$npx skills add JuliusBrussee/caveman --skill caveman-explore
GitHub stars
118,877
Pack installs
4.8M
Alyn Score
85/99
Updated
3 h ago
License
Apache-2.0

Install Caveman Explore

Pick your agent. Every command is ready to paste.

$npx skills add JuliusBrussee/caveman --skill caveman-explore

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads caveman-explore when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the caveman-explore skill”. In Codex, type $caveman-explore.

The skill itself

SKILL.md

GitHub

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:

path/to/file.ext:START-END reason it is relevant

Example reply:

src/router/pick.go:42-71 route selection — where a model is chosen src/router/pick_test.go:18-40 the table test covering pick()

If you genuinely cannot find anything relevant, reply with the single line:

no relevant locations found

That honest answer is better than a guess. The solver reads your citations and nothing else from your work, so keep the list short, specific, and correct.

Tips for Caveman Explore

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • This skill ships scripts. Read them before the first run, and run it in a project without secrets first.
  • • It is part of a pack with 22 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Caveman Explore

What does the Caveman Explore skill do?

Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the exact file or symbol is already named. Returns path:line citations only; its reads stay out of main context.

How do I install Caveman Explore?

Run "npx skills add JuliusBrussee/caveman --skill caveman-explore" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Caveman Explore work in Cursor and Codex?

Yes. Caveman Explore uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Caveman Explore free?

Caveman Explore is open source on GitHub under the Apache-2.0 license. It is free to install; check the license before commercial use.

Who made Caveman Explore?

Caveman Explore is published by JuliusBrussee in the JuliusBrussee/caveman repository, together with 21 other skills.

Similar skills. From other creators.