report-generator — Claude Code subagent: what it does and setup
Converts collected research notes into an organized Markdown document with numbered citations. It takes over at the final stage once all investigation data is ready.
npx claude-code-templates@latest --agent deep-research-team/report-generatorWhat report-generator does
This subagent organizes scattered research notes into a structured document. It handles the final drafting. For texts exceeding 1000 words, it writes an executive summary with 3–5 bullet points. The body text receives sequential reference tags like [1], while opposing arguments stay balanced without picking sides.
Under the hood, the agent relies on Read, Write, and Edit tools to process local files. It outputs clean Markdown. Depending on your instructions, the layout adapts to technical papers or policy reviews.
The subagent does not browse the web. It needs existing research notes to function. Running it without input data produces weak results, because the narrative requires verified facts.
What it helps with
- convert raw research notes into a structured Markdown document
- format source citations with sequential brackets such as
[1] - generate an executive summary with 3–5 highlights for lengthy texts
- present conflicting arguments fairly without unsupported bias
Example prompts for the agent
- Take the raw findings in
climate-notes.mdand use the report-generator subagent to write a structured final report. - Run report-generator on
findings/to assemble a technical document with methodology details and numbered references. - Use report-generator to turn the research notes in
ai-safety.txtinto an executive brief with a 4-point summary.
How to install report-generator
1claude-code-templates
npx claude-code-templates@latest --agent deep-research-team/report-generator2Manually: put the files in place
.claude/agents/report-generator.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/report-generator.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/report-generator.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 report-generator
How do I install report-generator in Claude Code?
Run npx claude-code-templates@latest --agent deep-research-team/report-generator in your project terminal. This places the subagent definition into .claude/agents/report-generator.md.
What does report-generator do?
It takes synthesized research findings and converts them into an organized Markdown document. The agent inserts numbered source citations, summarizes key takeaways, and formats comparison tables where needed.
Does report-generator collect web research on its own?
No, it does not browse the internet or conduct fresh searches. You need to supply synthesized findings first, as the agent focuses strictly on structuring and drafting the final document.