codebase-exploration

Installation
SKILL.md

SocratiCode Codebase Exploration

Use SocratiCode MCP tools to explore codebases efficiently. The core principle: search before reading — the index gives you a map of the codebase in milliseconds; raw file reading is expensive and context-consuming.

Workflow

1. Start most explorations with codebase_search

Hybrid semantic + keyword search (vector + BM25, RRF-fused) runs in a single call.

  • Broad queries for orientation: "how is authentication handled", "database connection setup", "error handling patterns"
  • Precise queries for symbol lookup: exact function names, constants, type names
  • Prefer search results to infer which files to read — do not speculatively open files
  • Use fileFilter to narrow to one file, exactly as a result header shows its path; a directory, glob or bare name of a file below the root matches nothing
  • Use languageFilter to narrow to one language, exactly as a result header shows its label in brackets (e.g. typescript, not ts)
  • Adjust minScore (default 0.10) for precision vs recall — lower for more results, higher for stricter matching
Installs
93
GitHub Stars
3.4K
First Seen
Apr 13, 2026