semantic-searchsearch
Use when searching the codebase with natural language queries like "authentication logic" or "database connection"
When & Why to Use This Skill
The Semantic Search skill enables developers to explore and navigate complex codebases using natural language instead of strict keyword matching. By understanding the intent behind queries like 'how is user session handled,' it retrieves relevant code snippets, file paths, and logic structures, significantly reducing the time spent on manual code discovery and improving developer productivity.
Use Cases
- Feature Discovery: Quickly locate specific business logic, such as 'authentication middleware' or 'payment gateway integration,' without knowing the exact function names.
- Architectural Analysis: Understand how system components interact by searching for high-level concepts like 'database connection pooling' or 'event bus configuration'.
- Codebase Onboarding: Help new developers navigate unfamiliar repositories by allowing them to ask questions about the code in plain English.
- Refactoring Support: Identify all semantically related code blocks across different languages and files to ensure consistent updates during system-wide changes.
| name | semantic-search:search |
|---|---|
| description | Use when searching the codebase with natural language queries like "authentication logic" or "database connection" |
Semantic Search
Search the codebase using natural language.
Action
- Take the user's query (everything after
/semantic-search:search) - Call
mcp__semantic-search__search_codewith:query: the user's search termsmax_results: 10 (default, adjust if user specifies)
- Present results clearly showing:
- File path and line numbers
- Code snippet
- Relevance score
Examples
User: /semantic-search:search authentication middleware
→ Search for "authentication middleware"
User: /semantic-search:search database connection pooling
→ Search for "database connection pooling"
Optional Filters
If user specifies filters, pass them:
language: "python", "typescript", etc.file_pattern: glob pattern like "**/*_test.py"chunk_type: "function", "class", "method"