Skip to main content
subagent CX Codex

search-specialist · voltagent/awesome-codex-subagents — Codex subagent: targeted codebase and source search

search-specialist is a Codex subagent that searches your repository and external sources before analysis. It finds where a function is called, locates a config file, or gathers code examples matching a pattern.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/search-specialist.toml
Open on GitHub

What search-specialist does

search-specialist operates within Codex and performs high-signal discovery in your codebase. Rather than dumping all matches, it ranks results by relevance, explains why each one matters, and hands off a next-step recommendation for deeper investigation.

The subagent clarifies what you're looking for, runs narrow queries that progressively tighten scope, and stops when further results yield diminishing returns. Results are packaged so another agent or analyst can act immediately.

Tools: relevance verification, blind-spot detection, duplication suppression, context snippets that explain the importance of each hit.

What it helps with

  • find all usages of a function or class in the codebase
  • locate config files or modules by searching for key patterns
  • gather code examples matching a style or pattern before refactoring
  • check whether a solution or similar attempt already exists in the repo

Example prompts for the agent

  • Find everywhere we parse JSON and show what errors happen when data is invalid
  • Search for all places where we call the Stripe API and list every method we use
  • Locate the database config file and tell me which driver is set up

How to install search-specialist

Manually: put the files in place

.codex/agents/search-specialist.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/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 Codex?

Place the config file at .codex/agents/search-specialist.toml or copy it into your Codex agents folder. The subagent will then appear in your project's subagent list.

What does search-specialist do?

It searches your codebase and external sources, then ranks hits by relevance, explains why each one matters, and suggests the next investigation path—not just a raw list of matches.

How is search-specialist different from IDE search?

IDE search returns all matches; search-specialist filters for relevance, removes noise, and prepares results so another specialist can act on them right away.

Source text

search-specialist.toml · MIT
# search-specialist

Use when a task needs fast, high-signal searching of the codebase or external sources before deeper analysis begins.

Own search execution as fast signal discovery for downstream analysis or implementation.

Optimize for precision, traceability, and next-step usefulness rather than exhaustive result dumps.

Working mode:
1. Clarify search objective and likely signal-bearing locations.
2. Run targeted queries that progressively narrow scope.
3. Rank hits by relevance and expected information gain.
4. Return concise hit set plus best next read/investigation path.

Focus on:
- high-yield query design for codebase and external source search
- progressive narrowing from broad indicators to concrete symbols/files
- relevance ranking by directness to the question
- duplication and noise suppression in returned results
- context snippets that explain why each hit matters
- search stop condition when diminishing returns begin
- handoff readiness for deeper specialist analysis

Quality checks:
- verify returned hits directly support the stated question
- confirm each hit includes reason-for-relevance context
- check for missing obvious high-signal areas before concluding
- ensure output is concise enough for immediate parent-agent action
- call out uncertainty when search space remains underexplored

Return:
- ranked high-signal hits with relevance explanation
- likely owner area/subsystem if evident
- strongest next file/source to inspect
- gaps or blind spots in current search pass
- recommended follow-up query path

Do not summarize large volumes of irrelevant text or pad with low-signal hits unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

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

search-specialist by other authors comes first.

search-specialist VoltAgent Community search-specialist — a subagent that hunts down precise information across many sources: builds queries, picks sources, filters results. Useful when the job is finding, not analyzing. CX Codex 6,886installs search-specialist Seth Hobson search-specialist — a web research subagent that filters sources and cross-checks facts. Use it for deep research, competitive analysis, and trend work. CX Codex 6,886installs morph-search parcadei morph-search — a skill for Claude Code, Cursor and other AI coders: searches codebases via WarpGrep, 20x faster than grep. Runs on command or when the agent needs to find a function, variable or pattern in a large project. CX Codex +1 493installs nhs-mcp-search United Ideas nhs-mcp-search searches 8,600+ AI tools, MCP servers and APIs in the Not Human Search index. Shows agentic readiness scores and verifies endpoints. ★ 1,013repo stars adopt haabe adopt — a Claude Code skill that runs discovery on a project where code already exists. It reads the repo, fills in what the code can establish, and lists the questions the code cannot answer. CX Codex +1 ★ 54repo stars agent-codebase-pattern-finder softaworks The agent-codebase-pattern-finder plugin for Claude Code finds similar implementations, usage examples, and existing patterns in your codebase, returning code snippets with context. ★ 2,707repo stars platform-capability-search forcedotcom The platform-capability-search skill tells you where you are in the Connect → Project → Build → Test → Deploy → Observe journey and finds a plugin for a task no installed skill covers. CX Codex +1 2,900installs ctx-search mksglu ctx-search searches a persistent project knowledge base without reloading source files into context. Queries indexed code, documentation, and session memory via FTS5. CX Codex +1 1,100installs

From the same set176

The whole set →
policy-guardrail-designer The policy-guardrail-designer subagent maps AI workflow risks to controls such as validation, approvals, and fallback behavior. Use it when you need guardrails that address specific failure paths. CX Codex ★ 6,505repo stars model-risk-manager model-risk-manager is a Codex subagent that analyzes AI failure modes and prioritizes mitigations for workflows where model decisions affect product outcomes. CX Codex ★ 6,505repo stars ai-governance-auditor ai-governance-auditor assesses AI boundaries, change management, and deployment readiness to spot critical operational risks before launch. CX Codex ★ 6,505repo stars trend-analyst The trend-analyst subagent turns technology and adoption signals into trend assessments for architecture, roadmap, and team planning decisions. CX Codex ★ 6,505repo stars scientific-literature-researcher scientific-literature-researcher gathers published research, checks sample sizes and methodologies, and synthesizes findings weighted by study quality. CX Codex ★ 6,505repo stars research-analyst research-analyst — a Codex subagent for structured technical research, source checks, and confidence-rated conclusions. Use it when an implementation or design decision needs evidence. CX Codex ★ 6,505repo stars project-idea-validator project-idea-validator — a Codex subagent that hunts fatal flaws in a product idea — rivals, demand, moat — and returns a kill, pivot or proceed call before you build. CX Codex ★ 6,505repo stars market-researcher market-researcher runs market and competitor research for technical product decisions. Helps evaluate build-vs-buy trade-offs, switching costs, and positioning. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open