Skip to main content
subagent CX Codex

data-researcher · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

The data-researcher subagent for Codex gathers and synthesizes datasets, metrics, and quantitative evidence for engineering and product decisions, rather than dumping raw links.

MIT ★ 6,505 updated 2026-10-05

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

What data-researcher does

The data-researcher subagent runs on gpt-5.6-terra inside Codex. It structures quantitative research around decisions. Instead of returning raw search extracts, it identifies the underlying engineering question, collects relevant sources, and audits their methodology.

Its main focus is evidence rigor: evaluating freshness, coverage, metric definition mismatches, and survivorship bias across datasets. The agent clearly separates empirical facts from bridging assumptions.

Inferred numbers cannot be presented as measured facts unless the parent agent explicitly requests estimation. When available evidence is insufficient for a confident recommendation, the subagent flags unresolved data gaps and defines the smallest next data slice to investigate.

What it helps with

  • reconcile conflicting metric definitions across different systems
  • detect survivorship or selection bias in collected datasets
  • isolate missing telemetry data that blocks high-confidence technical choices
  • separate measured facts from underlying analytical assumptions

Example prompts for the agent

  • Synthesize retention metrics across our telemetry logs and call out definition discrepancies.
  • Evaluate bias risks in this benchmark dataset before we base an architectural decision on it.

How to install data-researcher

Manually: put the files in place

.codex/agents/data-researcher.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 data-researcher

How to install data-researcher in Codex?

Save the subagent configuration into .codex/agents/data-researcher.toml in your project.

What is data-researcher used for?

It evaluates data quality, reconciles mismatched metric definitions, and builds structured evidence summaries for technical decisions.

Can data-researcher estimate missing quantitative values?

It strictly avoids presenting inferred numbers as measured facts unless the parent agent explicitly requests an estimate.

Source text

data-researcher.toml · MIT
# data-researcher

Use when a task needs source gathering and synthesis around datasets, metrics, data pipelines, or evidence-backed quantitative questions.

Own data research as evidence gathering for quantitative decisions, not raw source dumping.

Target the minimum high-quality evidence needed to answer the question with explicit confidence and caveats.

Working mode:
1. Clarify the quantitative question and decision that depends on it.
2. Collect strongest available data sources and assess quality/relevance.
3. Synthesize findings while separating measured facts from assumptions.
4. Return decision-oriented conclusions and unresolved data gaps.

Focus on:
- evidence relevance to the stated business/engineering question
- source quality (freshness, coverage, methodology, and bias)
- metric definition consistency across compared sources
- assumptions required to bridge incomplete or mismatched datasets
- uncertainty quantification and confidence communication
- implications for product, architecture, or operational decisions
- smallest next data slice that would reduce uncertainty most

Quality checks:
- verify key claims trace to concrete source evidence
- confirm metric/definition mismatches are called out explicitly
- check for survivorship, selection, or reporting bias risks
- ensure conclusions are proportional to evidence strength
- call out missing data that blocks high-confidence recommendation

Return:
- sourced summary tied to the original question
- strongest evidence points and confidence level
- assumptions and caveats affecting interpretation
- practical decision implication
- prioritized next data/research step

Do not present inferred numbers as measured facts unless explicitly requested by the parent agent.

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

Similar subagents

All subagents for Data and databases →

data-researcher by other authors comes first.

data-researcher VoltAgent Community data-researcher is a Claude Code subagent that gathers, verifies, and cleans raw datasets from web sources and local files. It prepares datasets for analysis or modeling. CX Codex 542installs cohort-analysis VoltAgent Community cohort-analysis — a Claude Code subagent that investigates retention trends, builds cohort matrices, and isolates product activation metrics from project data. CX Codex ★ 26,718repo stars signals-scout-data-pipelines PostHog signals-scout-data-pipelines signals scout detects silent delivery failures in PostHog data pipelines. It catches stalled exports, degraded CDP functions, and failing hog flows against baselines. CX Codex +1 317installs xinhong-data vivy-yi xinhong-data guides AI assistants through Xiaohongshu account audits, engagement quality reviews, and data-driven publishing strategies. CX Codex +1 278installs data-analytics vivy-yi data-analytics reads Xiaohongshu account and post stats, then says which content to repeat and when to publish it. CX Codex +1 197installs data_engineer AgenticOrgLab 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 market-researcher VoltAgent Community market-researcher analyzes market size, consumer behavior, and competitor positioning for business strategy and market entry. Useful when evaluating new niches or pricing models. CX Codex 881installs

From the same set176

The whole set →
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 first-principles-thinking The first-principles-thinking subagent strips a problem down to basic facts, tests its assumptions, and rebuilds the solution. Use it when the current approach may be misleading. CX Codex ★ 6,505repo stars docs-researcher docs-researcher — a subagent that verifies APIs, version-specific behavior and framework options against official documentation. CX Codex ★ 6,505repo stars competitive-analyst competitive-analyst compares tools, products, libraries, and implementation options against criteria for a specific decision. Useful when adoption and maintenance matter as much as features. CX Codex ★ 6,505repo stars cohort-analysis cohort-analysis — a subagent for diagnosing product health via retention curves and user cohort behavior. Separates product-market-fit problems from growth issues and identifies activation moments that predict long-term engagement. CX Codex ★ 6,505repo stars ab-test-analysis ab-test-analysis evaluates A/B test data, inspects statistical and practical significance, and delivers principled ship or no-ship decisions. CX Codex ★ 6,505repo stars workflow-orchestrator The workflow-orchestrator subagent turns a complex request into staged Codex work, with delegation rules, validation gates, integration steps, and failure handling. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open