semantic-searchsearch

Use when searching the codebase with natural language queries like "authentication logic" or "database connection"

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

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.
namesemantic-search:search
descriptionUse when searching the codebase with natural language queries like "authentication logic" or "database connection"

Semantic Search

Search the codebase using natural language.

Action

  1. Take the user's query (everything after /semantic-search:search)
  2. Call mcp__semantic-search__search_code with:
    • query: the user's search terms
    • max_results: 10 (default, adjust if user specifies)
  3. 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"