Catalog
JuliusBrussee/caveman-explore

JuliusBrussee

caveman-explore

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.

NewUpdated Oct 1, 2026

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.

Files3
3 files · 13.5 KB

Select a file to preview

Overall Score

82/100

Grade

B

Good

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

95

Quality

78

Clarity

88

Completeness

70

Summary

FastContext is a read-only repository explorer skill designed for fast, parallel code localization via Glob, Grep, and Read operations. It finds relevant code locations and returns citations as compact path:line references, optimizing for speed and low token cost. The skill explicitly forbids file edits, command execution, and solution proposals.

Detected Capabilities

file read (Read tool)glob pattern matching (Glob tool)grep pattern search (Grep tool)parallel execution of multiple queries

Trigger Keywords

Phrases that agents use to match this skill to user intent.

find code locationlocate symbol definitioncross-file searchcodebase explorationcold start orientation

Referenced Domains

External domains referenced in skill content, detected by static analysis.

www.apache.org

Use Cases

  • Quickly locate code symbols when exact file paths are unknown
  • Perform broad cross-file codebase search across multiple hypotheses in parallel
  • Cold-start repository orientation for a solver agent
  • Retrieve precise line number citations for downstream code analysis
  • Complement direct search when initial symbol lookup fails

Quality Notes

  • Strong scope boundaries: explicitly read-only, no edits or command execution
  • Clear operating pattern: parallel-first approach optimizes for token budget and speed
  • Well-defined output format: citations-only reply with path:START-END ranges enforces precision
  • Practical guidance on when to use vs. skip: avoids redundant execution when file is already named
  • Error handling documented: honest 'no relevant locations found' response beats guessing
  • Edge case coverage: warns against invented line ranges or ranges past EOF
  • Concise, actionable instructions with concrete example
  • Appropriate tool selection: only read-only tools, no side effects
  • No supporting documentation or examples of complex multi-hypothesis scenarios
  • No guidance on handling large repositories or performance limitations
  • Missing edge cases: binary files, symlinks, very large files, encoding issues
Model: claude-haiku-4-5-20251001Analyzed: Oct 1, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Version History

  1. v2.1

    Content updated

    ✦ AILicense expanded significantly; package.json dependencies updated.

    2026-10-01

    LATEST
  2. v2.0

    Contract changed: description

    ✦ AIDescription reworded to simplify activation guidance and clarify result handling.

    triggering2026-09-09

    View This Version
  3. v1.0

    2026-08-17

    View This VersionInitial version

Use JuliusBrussee/caveman-explore in your dev environment

Command Palette

Search for a command to run...