git:20260525.f1d7b5d to git:20260531.39e76ac

29 added, 29 removed. Audit A to A.

---

name: websearch

description: "Power search via Exa MCP. Modes: quick, deep research, code, docs, debug, news, compare. Use when searching the web, finding docs, debugging errors, or researching any topic."

---

Execute web searches via Exa MCP with intent-based routing, multi-pass deep research, and structured output with inline citations.

</objective>

**Query**: free-text after the skill name

**Modes** (mutually exclusive):

- - *(none)* — quick search, single pass, `web_search_exa`

- - `--deep` — multi-pass deep research with gap-driven iteration (3-5 sub-queries, max 3 passes)

- - `--code` — code examples, API docs, library usage via `get_code_context_exa`

- - `--docs <lib>` — crawl official documentation for a specific library

- - `--debug` — paste error message, find solutions (Stack Overflow, GitHub issues)

- - `--news` — recent news, category:news filter

- - `--compare` — compare 2+ options side by side via parallel queries

- - `--research` — academic papers, category:research paper

- - `--similar <url>` — find pages similar to a given URL

+ - *(none)*: quick search, single pass, `web_search_exa`

+ - `--deep`: multi-pass deep research with gap-driven iteration (3-5 sub-queries, max 3 passes)

+ - `--code`: code examples, API docs, library usage via `get_code_context_exa`

+ - `--docs <lib>`: crawl official documentation for a specific library

+ - `--debug`: paste error message, find solutions (Stack Overflow, GitHub issues)

+ - `--news`: recent news, category:news filter

+ - `--compare`: compare 2+ options side by side via parallel queries

+ - `--research`: academic papers, category:research paper

+ - `--similar <url>`: find pages similar to a given URL

**Filters**:

- - `--after <date>` — results published after date (ISO 8601 or natural: "last week")

- - `--before <date>` — results published before date

- - `--domain <d>` — restrict to domain(s), comma-separated

- - `--exclude <d>` — exclude domain(s)

- - `--fresh` — force live crawl (maxAgeHours=0)

- - `--locale <CC>` — country code for localized results

- - `-n <num>` — number of results (default: 5, max: 20)

+ - `--after <date>`: results published after date (ISO 8601 or natural: "last week")

+ - `--before <date>`: results published before date

+ - `--domain <d>`: restrict to domain(s), comma-separated

+ - `--exclude <d>`: exclude domain(s)

+ - `--fresh`: force live crawl (maxAgeHours=0)

+ - `--locale <CC>`: country code for localized results

+ - `-n <num>`: number of results (default: 5, max: 20)

**Output**:

- - `--save <file>` — save report to markdown file

- - `--json` — structured JSON output

- - `--full` — full text instead of highlights (more tokens)

+ - `--save <file>`: save report to markdown file

+ - `--json`: structured JSON output

+ - `--full`: full text instead of highlights (more tokens)

**Help**:

- - `--info` — display detailed tutorial with all modes, flags, and examples

+ - `--info`: display detailed tutorial with all modes, flags, and examples

</parameters>

<state_variables>

- - {mode}: string — detected search mode (quick|deep|code|docs|debug|news|compare|research|similar)

- - {query}: string — cleaned search query

- - {filters}: object — parsed Exa filters (dates, domains, locale, numResults)

- - {output_opts}: object — save path, json flag, full text flag

- - {lib_name}: string — library name if --docs mode

- - {similar_url}: string — URL if --similar mode

- - {results}: array — accumulated search results across passes

- - {pass_count}: number — current iteration for deep mode

- - {gaps}: array — identified knowledge gaps for deep iteration

+ - {mode}: string (detected search mode: quick|deep|code|docs|debug|news|compare|research|similar)

+ - {query}: string (cleaned search query)

+ - {filters}: object (parsed Exa filters: dates, domains, locale, numResults)

+ - {output_opts}: object (save path, json flag, full text flag)

+ - {lib_name}: string (library name if --docs mode)

+ - {similar_url}: string (URL if --similar mode)

+ - {results}: array (accumulated search results across passes)

+ - {pass_count}: number (current iteration for deep mode)

+ - {gaps}: array (identified knowledge gaps for deep iteration)

</state_variables>

<entry_point>

Load `steps/step-00-triage.md`

</entry_point>

<step_files>

| Step | File | Purpose |

|------|------|---------|

| 00 | steps/step-00-triage.md | Parse flags, classify intent, build Exa params |

| 01 | steps/step-01-search.md | Execute search strategy per mode |

| 02 | steps/step-02-deep.md | Deep iteration: evaluate, find gaps, re-query |

| 03 | steps/step-03-report.md | Synthesize, cite, format, optionally save |

</step_files>

| File | Content |

|------|---------|

| references/domain-presets.md | Curated domain lists per ecosystem/intent |

| references/query-patterns.md | Optimal Exa query formulation per search type |

| references/info-text.md | Full tutorial displayed by --info flag |

</references>

ALL web access via Exa MCP only. NEVER use WebSearch, WebFetch, or Context7.

Tools: mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, mcp__exa__crawling_exa, mcp__exa__web_search_advanced_exa.

</critical>