search-debug

Installation
SKILL.md

Search Debug

Diagnose why a Julie search returns unexpected results. Use this when a search misses an expected symbol, ranks it too low, or returns irrelevant results. This skill is for Julie dogfooding, not general plugin usage.

Process

Step 1: Reproduce the Search

Run the exact search the user reported:

fast_search(query="<original_query>", limit=20)

fast_search returns mixed-kind results; each hit carries kind. Note what comes back, the top results, their scores, and what's missing. If the default response says "No lexical results. Showing semantic fallback candidates.", treat that as a semantic rescue, not a lexical hit.

If the report involves backend behavior, run the exact requested backend and compare backend="lexical", backend="semantic", and backend="hybrid". Explicit lexical stays pure lexical for bakeoffs; semantic and hybrid are symbol-only concept search.

Step 2: Verify the Expected Symbol Exists

Installs
1
Repository
anortham/julie
GitHub Stars
6
First Seen
Jun 16, 2026
search-debug — anortham/julie