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
fileFilterto 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
languageFilterto narrow to one language, exactly as a result header shows its label in brackets (e.g.typescript, notts) - Adjust
minScore(default 0.10) for precision vs recall — lower for more results, higher for stricter matching