Code Tools Skill

You have loaded the Code Tools Skill - The unified entry point for all code operations.

Primary Command

code_search

• Unified Search Interface

This is the ONLY search tool you should use.

Structure search (finds class/function definitions)

code_search("class User") code_search("def authenticate")

Semantic search (finds conceptually related code)

code_search("how does authentication work") code_search("user validation logic")

Text search (finds exact matches)

code_search("TODO: fix") code_search("FIXME: memory leak")

Returns XML-formatted results optimized for LLM consumption.

Search Strategy Selection

The tool automatically selects the best strategy:

Query Type Strategy Example

class Foo

AST Structural definition search

def foo()

AST Function signature search

Questions Vector Semantic/conceptual search

TODO , FIXME

Grep Exact text match

Workflow

1. SEARCH code_search("...") # Unified entry point ↓
2. INTERPRET XML RESULTS
   • <item> for focused results
   • <search_interaction> for refinement suggestions ↓
3. REFINE (if needed) code_search("class ClassName") # More specific ↓
4. READ FILE (for implementation details) read_file("path/to/file.py")

Best Practices

• Always use code_search for all code discovery tasks

• Be specific: code_search("class UserAuth")

code_search("auth")

• Check XML guidance: If results are too broad, the XML will suggest refinements

• Read files for details: Use read_file after finding the right file

Search Engines

Engine Use Case Examples

AST Class/function definitions class Foo , def bar

Vector Conceptual queries "how does auth work"

Grep Exact text TODO , "error message"