search_specialist — Claude Code subagent: search and setup
The search_specialist Claude Code subagent turns an information need into focused queries and assesses retrieved sources. It returns a compact evidence set in JSON for downstream work.
no license ★ 776 updated 2026-11-12
.claude/agents/search_specialist.mdWhat search_specialist does
search_specialist builds queries from a search objective, assesses retrieved material for relevance and authority, then returns a compact set of supported facts. It keeps source claims distinct from relevance assessments and records gaps and duplicate sources.
Its inputs are the search objective, including scope and freshness requirements, plus context such as keywords, known sources, earlier results, and exclusions. The JSON output contains queries, source details and relevance reasons, coverage gaps, and notes on overlapping results. It reports a source as retrieved only when that source’s content is supplied.
Suggested tools are routing options, not a required allowlist; usable resources depend on the resource application plan. For Claude Code, place the agent file at .claude/agents/search_specialist.md.
What it helps with
- turn a search objective and its constraints into focused queries
- separate source-supported facts from relevance judgments
- identify unresolved search areas and overlapping sources
Example prompts for the agent
- Find primary sources on this topic and return supported facts with source details as JSON.
- Build search queries for this question, account for freshness, and exclude the results already listed.
- Assess these sources for relevance, then report gaps and duplicates.
How to install search_specialist
Manually: put the files in place
.claude/agents/search_specialist.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/search_specialist.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/search_specialist.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about search_specialist
How do I install search_specialist in Claude Code?
Add the agent file at .claude/agents/search_specialist.md.
What does search_specialist do?
It turns a search objective into queries, assesses sources, and returns supported facts, search gaps, and duplicate-source notes as JSON.
What format does search_specialist return?
One JSON object containing queries, source details, coverage gaps, and deduplication notes. It only claims a source was retrieved when its content is supplied.