C

caveman-explore

by @juliusbrusseev
4.8(120)

This skill is a read-only repository explorer. When you face a cold-start exploration, need to locate a feature across many files, or a direct search has failed, it fans out parallel searches and reads, then returns compact path:line citations. It helps developers and AI agents find where code lives fast, saving tokens and time. It is designed for cold-start scenarios and for cases where a previous direct search has failed, avoiding wasted effort in unrelated files.

code-explorationrepository-searchread-onlypath-citationai-agentGitHub
Installation
npx skills add https://github.com/juliusbrussee/caveman --skill caveman-explore
compare_arrows

Before / After Comparison

1 组
Before

Without this skill, developers facing an unfamiliar codebase had to open files based on guesses and navigate back and forth, spending significant time to locate relevant code and often missing key files.

After

This skill runs parallel searches and returns precise path:line citations, letting developers get straight to the evidence, quickly localizing code and saving exploration time.

SKILL.md

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.

User Reviews (0)

Write a Review

Effect
Usability
Docs
Compatibility

No reviews yet

Statistics

Installs103.8K
Rating4.8 / 5.0
Version
Updated2026年10月23日
Comparisons1

User Rating

4.8(120)
5
37%
4
43%
3
13%
2
5%
1
2%

Rate this Skill

0.0

Compatible Platforms

🤖claude-code

Timeline

Created2026年8月13日
Last Updated2026年10月23日
🎁 Agent Knowledge Cards
Survey