How do I install the Search Tools skill?

Run npx skillmds@latest add vibeeval/search-tools in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Search Tools skill do?

Search Tool Hierarchy It is listed under Coding & Dev Tools on SkillMD.

Is Search Tools safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Search Tools?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Search Tools free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Search Tools?

vibeeval (@vibeeval) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Search Tools by vibeeval — Agent Skill

Name: Search Tools
Author: vibeeval

File contents

Search Tool Hierarchy

When searching code, use this decision tree:

Decision Tree

Need CONCEPTUAL/SEMANTIC search?
  (how does X work, find patterns, understand architecture)
  → Use LEANN (/leann-search) - embedding-based semantic search
  → PreToolUse hook auto-redirects semantic Grep queries

Need to understand code STRUCTURE?
  (find function calls, class usages, refactor patterns)
  → Use AST-grep (/ast-grep-find)

Need to find TEXT in code?
  → Use Morph (/morph-search) - 20x faster
  → If no Morph API key: fall back to Grep tool

Simple one-off search?
  → Use built-in Grep tool directly

Tool Comparison

Tool	Best For	Requires
LEANN	Semantic search: "how does caching work", "error handling patterns", conceptual queries	Index built
AST-grep	Structural patterns: "find all calls to `foo()`", refactoring, find usages by type	MCP server
Morph	Fast text search: "find files mentioning error", grep across codebase	API key
Grep	Literal patterns, class/function names, regex	Nothing (built-in)

Examples

LEANN (semantic/conceptual):

"how does authentication work"
"find error handling patterns"
"where is rate limiting implemented"

AST-grep (structural):

"Find all functions that return a Promise"
"Find all React components using useState"
"Refactor all imports of X to Y"

Morph (text search):

"Find all files mentioning 'authentication'"
"Search for TODO comments"

Grep (literal):

class ProviderAdapter
def __init__
Regex patterns

LEANN Commands

# Search with semantic query
leann search opc-dev "how does blackboard communication work" --top-k 5

# List available indexes
leann list

# Rebuild index (when code changes)
leann build opc-dev --docs dir1 dir2 --no-recompute --no-compact --force

---name: search-toolsdescription: Search Tool Hierarchy---# Search Tool HierarchyWhen searching code, use this decision tree:## Decision Tree```Need CONCEPTUAL/SEMANTIC search? (how does X work, find patterns, understand architecture) → Use LEANN (/leann-search) - embedding-based semantic search → PreToolUse hook auto-redirects semantic Grep queriesNeed to understand code STRUCTURE? (find function calls, class usages, refactor patterns) → Use AST-grep (/ast-grep-find)Need to find TEXT in code? → Use Morph (/morph-search) - 20x faster → If no Morph API key: fall back to Grep toolSimple one-off search? → Use built-in Grep tool directly```## Tool Comparison| Tool | Best For | Requires ||------|----------|----------|| **LEANN** | Semantic search: "how does caching work", "error handling patterns", conceptual queries | Index built || **AST-grep** | Structural patterns: "find all calls to `foo()`", refactoring, find usages by type | MCP server || **Morph** | Fast text search: "find files mentioning error", grep across codebase | API key || **Grep** | Literal patterns, class/function names, regex | Nothing (built-in) |## Examples**LEANN** (semantic/conceptual):- "how does authentication work"- "find error handling patterns"- "where is rate limiting implemented"**AST-grep** (structural):- "Find all functions that return a Promise"- "Find all React components using useState"- "Refactor all imports of X to Y"**Morph** (text search):- "Find all files mentioning 'authentication'"- "Search for TODO comments"**Grep** (literal):- `class ProviderAdapter`- `def __init__`- Regex patterns## LEANN Commands```bash# Search with semantic queryleann search opc-dev "how does blackboard communication work" --top-k 5# List available indexesleann list# Rebuild index (when code changes)leann build opc-dev --docs dir1 dir2 --no-recompute --no-compact --force```

Frequently asked questions

Search Tools