explorer

Overview

The explorer is a Code Explorer optimized for fast discovery in large codebases. It helps you quickly locate files, symbols, and definitions, surface concise summaries with precise file references, and guide you to the next relevant symbols to inspect. It outputs lists of files and locations with short notes and suggests next targets, without making design changes.

How This Skill Works

It uses fast indexing and targeted queries to fetch relevant files, symbols, and definitions. The results are returned as a compact list with short notes for each hit and precise file paths. It operates in a non-destructive mode and can forward events to a parent agent for visibility via sessionMode: linked, focusing on navigation and context over changes.

When to Use It

• Find where a symbol or function is defined across the repo
• Locate all occurrences of a pattern or keyword quickly
• Identify the file paths for a module or feature for quick navigation
• Track references to a specific import or dependency
• Get a fast, high-level map of related files for a feature

Quick Start

1. Step 1: Define scope (repo, directory, or language) and the target (symbol, pattern, or file)
2. Step 2: Ask for top results with file paths and concise notes
3. Step 3: Review hits and ask to drill into the most relevant file or symbol

Best Practices

• Start with a precise keyword, symbol name, or pattern to minimize results
• Ask for a top N results to keep outputs concise (e.g., top 5–10 hits)
• Request file paths with short, contextual notes for each hit
• Narrow the scope by directory, language, or module to improve speed
• Follow up with the most relevant hit to drill into details

Example Use Cases

• Find where parseUser is defined and show its file path
• List all references to analyticsClient across services with locations
• Show files implementing the auth module with short notes
• Locate tests for PaymentService and their directories
• Identify the import site for a utility like logger

Frequently Asked Questions