Codebase Exploration

Map codebases via LSP symbol navigation and return structured JSON reports.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/StrategicMilk/Vetinari-Orchestrastor --skill codebase-exploration-strategicmilk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Codebase Exploration
Source: https://github.com/StrategicMilk/Vetinari-Orchestrastor/tree/main/vetinari/skills/catalog/worker/codebase-exploration
Command: npx skills add https://github.com/StrategicMilk/Vetinari-Orchestrastor --skill codebase-exploration-strategicmilk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Navigating large or unfamiliar codebases is time-consuming and error-prone when relying on text search alone; this Skill provides a systematic, progressive-zoom approach to locate relevant files, symbols, and call chains with precision using language-server tooling.

Core Features & Use Cases

  • Progressive Zoom Navigation: Directory survey, file identification, symbol enumeration, signature analysis, and line-level deep dives to minimize unnecessary reading.
  • LSP-Powered Call Graphs: Uses document-symbols, goto-definition, and find-references to build accurate call chains and identify entry points and dead code.
  • Structured Reports & Gap Identification: Produces JSON exploration reports with provenance, pattern summaries, and detected gaps (missing tests, docstrings, dead code) to guide subsequent build or refactor tasks.
  • Use Cases: Onboarding developers to a new repository, impact analysis before changes, tracing data flows, and preparing a style-consistent implementation plan.

Quick Start

Explore the codebase starting at vetinari/agents/consolidated/ to map modules, list public APIs and callers, and produce a structured report summarizing patterns and gaps.

Frequently Asked Questions about Codebase Exploration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map an unfamiliar codebase to find relevant files and symbols?

To map an unfamiliar codebase, use a progressive-zoom approach: survey directories, identify files, enumerate symbols via LSP document-symbols, and extract signatures to minimize unnecessary reading. This produces a structured JSON report with provenance for precise navigation.

What is the best way to build a call graph for impact analysis before a refactor?

Building a call graph for impact analysis requires using LSP goto-definition and find-references to trace accurate call chains. This method identifies entry points and dead code, providing a structured report to safely guide refactoring tasks across multi-module projects.

Can I use LSP to identify missing tests and docstrings during codebase exploration?

Yes, LSP-powered codebase exploration can identify missing tests and docstrings by extracting signatures and analyzing symbol structures. The structured JSON exploration report includes detected gaps like dead code and missing documentation to guide subsequent build tasks.

How do I trace data flows across multi-module projects without reading every file?

Tracing data flows without reading every file is achieved through progressive-zoom navigation using LSP find-references and goto-definition. This pinpoints exact call chains and symbol dependencies, returning a structured report so you only read relevant line-level code.

Does codebase exploration work for developer onboarding in large repositories?

Codebase exploration works effectively for developer onboarding by systematically mapping large repositories. It surveys directories, enumerates public APIs, and lists callers using LSP tooling, rapidly bringing new developers up to speed with structured JSON reports.

When should I not use text search alone for navigating unfamiliar code?

You should not use text search alone when precise symbol navigation is required, as it is time-consuming and error-prone. For multi-module projects, LSP-powered call graphs and dependency analysis provide accurate entry points and dead code detection that text search misses.