Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/search_specialist.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set24

The whole set →
source_verification The source_verification Claude Code skill ties claims to supporting sources. It helps check dates, figures, and entity identity in research responses. CX Codex +1 ★ 776repo stars web_navigation The web_navigation Claude Code skill reads public web pages and gathers evidence for specific facts. It follows relevant links to find supporting details. CX Codex +1 ★ 776repo stars frontend_developer The frontend_developer Claude Code subagent turns UI requirements and repository context into an implementation plan and code-ready changes. It covers responsive layouts, accessibility, and interface states. CX Codex ★ 776repo stars security_auditor security_auditor — a subagent for Claude Code runs defensive application security reviews. Inspects source code, configurations, and dependency scanner logs to report exploitable flaws. CX Codex ★ 776repo stars data_engineer The data_engineer Claude Code subagent designs batch and streaming data pipelines from stated requirements. It returns a Markdown specification covering data flow, quality checks, and operations. CX Codex ★ 776repo stars product_manager product_manager is a Claude Code subagent that turns a product question and available evidence into a clear decision. It helps compare options, set priorities, and define how to measure results. CX Codex ★ 776repo stars api_designer The api_designer Claude Code subagent turns product or service requirements into REST or GraphQL API contracts. It runs on API specification tasks. CX Codex ★ 776repo stars database_optimizer database_optimizer — a subagent for Claude Code, Codex, and Cursor reviews database performance evidence and proposes optimizations. It ranks bottlenecks and outlines how to measure proposed changes. CX Codex ★ 776repo stars

Project sponsors

Companies that keep this analytics open