Codebase Search Skill

When to Use What

Scenario	Tool	Why
Just need file locations	`codebase_peek`	Metadata only, saves ~90% tokens
Need to see actual code	`codebase_search`	Returns full code content
Find duplicates/patterns	`find_similar`	Given code snippet → similar code
Understand code flow	`call_graph`	Find callers/callees of any function
Don't know function/class names	`codebase_peek` or `codebase_search`	Natural language → code
Know exact identifier names	`grep`	Faster, more precise
Need ALL occurrences	`grep`	Semantic returns top N only

Locate with peek: codebase_peek("authentication flow") → get file locations
Read what matters: Read the specific files you need
Drill down with grep: grep "validateToken" for exact matches