search-router

Route search queries to the most token-efficient tool by query type.

3.9k|296|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/parcadei/Continuous-Claude-v3 --skill search-router-parcadei
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search-router
Source: https://github.com/parcadei/Continuous-Claude-v3/tree/main/.claude/skills/search-router
Command: npx skills add https://github.com/parcadei/Continuous-Claude-v3 --skill search-router-parcadei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill optimizes search operations by selecting the most token-efficient tool for different types of queries, preventing unnecessary token consumption and improving response times.

Core Features & Use Cases

  • Intelligent Tool Selection: Automatically chooses between TLDR Search, AST-grep, Grep, or Read based on the query's nature (code exploration, structural patterns, semantic meaning, or literal text).
  • Token Efficiency: Prioritizes tools like TLDR Search for significant token savings (up to 95%).
  • Use Case: When asked to "find all usages of the process_data function," the router will correctly select TLDR Search, avoiding the higher token cost of Grep for code-related queries.

Quick Start

Use the search-router skill to find where the 'UserSession' class is defined.

Frequently Asked Questions about search-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize token usage when performing code search operations?

To optimize token usage during code search, you need a routing mechanism that selects the most token-efficient tool based on query type. This approach prioritizes TLDR Search and AST-grep over Grep and Read, achieving up to 95% token savings for code exploration queries.

What is the best way to search for structural code patterns without wasting tokens?

The best way to search structural code patterns is using AST-grep for structural analysis. By routing structural queries to AST-grep instead of standard text matching tools, you get precise pattern detection while minimizing unnecessary token consumption.

When do I need to use a search router for code exploration instead of standard grep?

You need a search router for code exploration when queries involve semantic understanding or finding usages like a function call. The router intercepts these code-related queries and redirects them to TLDR Search, avoiding the significantly higher token cost of standard Grep.

How do I find where a class is defined using token-efficient search tools?

To find where a class is defined efficiently, route your code exploration query to TLDR Search. This intelligent tool selection prevents unnecessary token consumption by matching the query nature with the most efficient available search mechanism.

Does the search router handle literal text matching differently from semantic code understanding?

Yes, the search router handles literal text matching differently from semantic code understanding by evaluating the query type. It separates code exploration, structural analysis, semantic understanding, and literal text matching to choose between TLDR Search, AST-grep, Grep, or Read.