Query Expansion

Turn one question into three queries that cover different phrasings.

Single skill Verified 11 Nov searchretrievalagents

Use it for

Search that misses because the page uses different words than the question

Skip it if

Exact-match lookups — expansion makes those worse

What it is

Rewrites a user question into three search queries: the literal one, a synonym-based one, and one aimed at the likely document title. The rule that keeps it useful is deduplication — three variants of the same query waste budget without improving recall.

Install

Clone the repository, then copy the skill folder into your agent's skills directory — ~/.claude/skills/ for Claude Code. Skills are plain files: no build step, no daemon.

Terminal
npx skills add query-expansion

How to judge it

Read the SKILL.md before you install. A good skill states when it applies, what it must not do, and how to verify the result. A skill that only lists adjectives will change the agent's tone without improving its output — skip those.

Other Search & Research skills

  • SERP Gap Analysis — Compare the top results for a query and list what they all leave out.
  • Search Result Eval — Score a search result set for relevance before an agent trusts it.
  • Scientific Agent Skills — A large scientific skill library: bioinformatics, chemistry, clinical, analytics.

Tools it pairs with

All tools

Servers it runs on

All servers
  • 01
    Pexels MCPCommunity

    A community server for the Pexels API: search photos and videos by query, orientation, and size. It solves the image problem for content templates where a generic ph…

    #stock#photos#search
    TypeScriptstdio
  • 02
    Unsplash MCPCommunity

    A community server for Unsplash search and photo metadata. Unsplash's strength is editorial photography rather than product shots, which makes it the better fit for …

    #stock#photography#search
    TypeScriptstdio
  • 03
    Brave SearchOfficialArchived

    Adds web and local search through the Brave Search API, returning titles, snippets, and URLs the agent can then fetch. Requires your own API key. Archived, but still…

    #search#web#archived
    TypeScriptstdio