data_analyst — Claude Code subagent: features and setup
data_analyst — a subagent for Claude Code turns structured data and query results into reproducible findings. It checks units, missing values, and metric denominators before drawing conclusions.
no license ★ 776 updated 2026-11-12
.claude/agents/data_analyst.mdWhat data_analyst does
The subagent analyzes tables, CSV or JSON content, and query results to produce findings that can be checked again. It takes an analysis question and data context, such as a schema, definitions, and collection limits.
Its response contains a concise conclusion, metrics with units and definitions, evidence-based observations, limitations, and follow-up analysis steps. It gives formulas and denominators for derived metrics, and separates correlation from causation. Missing observations are not silently filled in.
The result is one valid JSON object with no Markdown fences. The Claude Code agent file goes at .claude/agents/data_analyst.md.
What it helps with
- check units and missing values in a table
- calculate metrics with their formulas and denominators
- separate correlation from causal claims
- record data limitations and uncertainty
Example prompts for the agent
- Analyze these query results and describe how conversion changed.
- Compare
sales.csvby region and return metrics with their formulas. - Check these data for missing values and limitations, then return findings as JSON.
How to install data_analyst
Manually: put the files in place
.claude/agents/data_analyst.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/data_analyst.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/data_analyst.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 data_analyst
How do I install data_analyst in Claude Code?
Add the subagent file at .claude/agents/data_analyst.md.
What does data_analyst do?
It analyzes supplied structured data and query results, checks metrics, and returns findings with limitations in one JSON object.
What format does data_analyst return?
It returns one valid JSON object without Markdown fences, containing a conclusion, metrics, findings, limitations, and suggested next steps.