Menu
Explore a codebase to gather context for coding tasks. Preserves context window and offloads work to cheaper models.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use this when you need a complete interactive report as a single HTML file with zero install dependencies — covers charts, tables, diagrams, math, KPIs, and prose out of the box.
Use this as the default toolset for coding sessions when you want faster navigation, search, file inspection, and git workflow execution with lower command overhead: tools: - fzf - ripgrep - bat - delta - lazygit - starship - zoxide - eza - atuin - yazi
Out-of-band codebase exploration using a cheap/fast model. Keeps your context clean while a cheap model runs 30-80 commands in parallel. Tunable precision and output size - works for broad orientation or precise targeted questions.
Deterministically fixes broken OpenAI Deep Research markdown citations without using an LLM: creates a .bkp backup, rewrites citation markers, rebuilds references, and runs strict regex validation.
Dynamically generate and execute a specialized agent for any task. Use when the user has an arbitrary task that would benefit from a custom-generated agent.
Fast, deterministic repository orientation: get a compact map of important files and symbols before deep code reading.
| name | codebase-explorer |
| description | Explore a codebase to gather context for coding tasks. Preserves context window and offloads work to cheaper models. |
Use this skill to gather codebase context before coding tasks. A staff architect agent explores using tree, ripgrep, and file reading, extracting imports, signatures, and code segments.
$HOME/.agents/skills/codebase-explorer/run.sh "<task>" [-d <directory>] [--token-budget N] [--max-iterations N]
# Explore for test writing
./run.sh "Write tests for the UserService class"
# Explore specific directory
./run.sh "Understand the authentication flow" -d src/auth
# With custom budget
./run.sh "Find all API endpoints" --token-budget 20000 --max-iterations 5
Returns structured context:
summary: narrative overview of the codebasefrozen_imports: relevant import statementsfrozen_signatures: function/class signaturesfrozen_segments: code blocks with file pathstree_outputs: directory structurefile_contents: full files that were read