codebase-exploration

SKILL.md

Systematic codebase search and pattern discovery for locating implementations, understanding architecture, and answering location-based code questions.

Supports three thoroughness levels (quick, medium, very thorough) ranging from 30 seconds to 10 minutes, scaling from broad file structure overview to exhaustive dependency tracing

Uses multiple search strategies including grep/rg for text patterns, ast-grep for code structure, LSP tools for symbol references, and git history for context

Designed for exploration tasks like finding where functionality is implemented, mapping architectural patterns, locating API endpoints, and tracing data flow across files

Includes decision framework for selecting appropriate search strategy based on question type (location queries, data flow, API handling, database queries, error handling)

Codebase Exploration

Purpose

Specializes in systematic codebase exploration and discovery. Uses advanced search techniques, pattern recognition, and code analysis to quickly understand unfamiliar code, locate specific implementations, map architectural patterns, and answer location-based questions about code.

When to Use

Exploring an unfamiliar codebase for the first time

Need to find where specific functionality is implemented

Looking for examples of a pattern across the codebase

Understanding how components interact

Locating all usages of a particular API or pattern

Mapping architectural organization

Finding similar code across the project

Questions like "Where is X?", "Which file has Y?", "Find code that does Z"

Quick Start