Report Builder — Comprehensive Research Report Generator
Build publication-quality reports using a hierarchical mesh swarm of specialist agents, multi-LLM research, professional LaTeX typesetting, Python-generated analytics, diagrams-as-code, and AI-powered infographic generation.
When to Use This Skill
- Creating research reports, white papers, or sector analyses
- Building comprehensive documents with data, charts, and citations
- Producing policy briefs or government-quality publications
- Any document needing professional LaTeX with figures, tables, bibliography
- Reports requiring Wardley maps, causal diagrams, or strategic visualisations
When Not To Use
- For simple markdown documents that do not need LaTeX formatting — just write markdown directly
- For presentations — use Beamer via the
latex-documents skill instead
- For single-figure chart generation — use Python directly without the full report pipeline
- For API documentation — use the
docs-alignment skill instead
- For diagrams only without a full report — use the
mermaid-diagrams skill instead
What This Skill Produces
A complete report package:
- Compiled PDF (LaTeX book class, A4, professional typography)
- Python-generated charts (matplotlib/seaborn, PDF vector output)
- Diagrams-as-code (TikZ + Mermaid with Nano Banana infographic upgrade)
- Full bibliography (BibLaTeX/Biber with 100+ cited sources)
- Index, glossary, list of figures/tables
- Appendices with deep technical data
- Git-tracked with clean commits at each version
Quick Start
1. Define Your Report
/report-builder "UK Water Sector Analysis" --topics 5 --depth comprehensive
Or provide a brief:
/report-builder --brief "Analyse the five most pressing challenges facing
the UK water sector, with data-driven projections, Wardley mapping,
and policy recommendations. Target audience: government policy makers."
2. Preflight
report-preflight # on PATH from the agentbox-ops crate
Preflight reports which tools and API keys are available and degrades gracefully
when optional features (Nano Banana infographics, cross-LLM review, Perplexity
research) are unavailable. Full prerequisite matrix in
references/reference.md.
3. The Six-Phase Pipeline
Phase 1 RESEARCH → parallel research swarm, Perplexity search, structured data
Phase 2 STRUCTURE → LaTeX skeleton (book class), figure/table/diagram plan
Phase 3 WRITE → parallel chapter agents, Python charts, BibLaTeX, compile
Phase 4 VISUALISE → TikZ/Mermaid renders, Nano Banana infographic upgrade
Phase 5 REVIEW → 4 specialist reviewers + optional cross-LLM review + optional
prose-sanitiser de-slop pass
Phase 6 PUBLISH → clean 3-pass build, PDF verify, asset audit, git commit
Per-phase mechanics — swarm topology, report directory layout, chart style,
diagram commands, reviewer roles, the final clean-build script, and quality gates —
are in references/pipeline.md.
Quality Gates
- 0 LaTeX errors
- Every
\includegraphics resolves to an existing file; no unused generated assets
- PDF renders correctly via PyMuPDF
- UK English throughout (babel british)
References
references/pipeline.md — detailed six-phase guide (topology, structure, charts, diagram pipeline, review, final assembly).references/reference.md — prerequisites, configuration (report-config.yaml, colour schemes), skill integration map, troubleshooting, example output, scripts/resources catalog.
Scripts
| Script |
Purpose |
report-preflight |
Check all prerequisites and API keys |
scripts/compile_report.sh |
Full LaTeX build pipeline with verification |
scripts/asset_audit.sh |
Check all figures referenced and present |
See references/reference.md for the full script and resource catalog (including templates and figure/pipeline generators).
1---2name: report-builder3description: Generate publication-quality LaTeX reports — white papers, sector analyses, policy briefs, technical documentation — with data-driven charts, diagrams-as-code, citations, and multi-agent quality review. Use when a document needs professional typesetting with figures, tables, bibliography, and strategic visualisations (Wardley maps, causal diagrams); not for a plain markdown write-up.4---56# Report Builder — Comprehensive Research Report Generator78Build publication-quality reports using a hierarchical mesh swarm of specialist agents, multi-LLM research, professional LaTeX typesetting, Python-generated analytics, diagrams-as-code, and AI-powered infographic generation.910## When to Use This Skill1112- Creating research reports, white papers, or sector analyses13- Building comprehensive documents with data, charts, and citations14- Producing policy briefs or government-quality publications15- Any document needing professional LaTeX with figures, tables, bibliography16- Reports requiring Wardley maps, causal diagrams, or strategic visualisations1718## When Not To Use1920- For simple markdown documents that do not need LaTeX formatting — just write markdown directly21- For presentations — use Beamer via the `latex-documents` skill instead22- For single-figure chart generation — use Python directly without the full report pipeline23- For API documentation — use the `docs-alignment` skill instead24- For diagrams only without a full report — use the `mermaid-diagrams` skill instead2526## What This Skill Produces2728A complete report package:29- **Compiled PDF** (LaTeX book class, A4, professional typography)30- **Python-generated charts** (matplotlib/seaborn, PDF vector output)31- **Diagrams-as-code** (TikZ + Mermaid with Nano Banana infographic upgrade)32- **Full bibliography** (BibLaTeX/Biber with 100+ cited sources)33- **Index, glossary, list of figures/tables**34- **Appendices** with deep technical data35- **Git-tracked** with clean commits at each version3637## Quick Start3839### 1. Define Your Report4041```markdown42/report-builder "UK Water Sector Analysis" --topics 5 --depth comprehensive43```4445Or provide a brief:4647```markdown48/report-builder --brief "Analyse the five most pressing challenges facing49the UK water sector, with data-driven projections, Wardley mapping,50and policy recommendations. Target audience: government policy makers."51```5253### 2. Preflight5455```bash56report-preflight # on PATH from the agentbox-ops crate57```5859Preflight reports which tools and API keys are available and degrades gracefully60when optional features (Nano Banana infographics, cross-LLM review, Perplexity61research) are unavailable. Full prerequisite matrix in62[`references/reference.md`](references/reference.md#prerequisites-check).6364### 3. The Six-Phase Pipeline6566```67Phase 1 RESEARCH → parallel research swarm, Perplexity search, structured data68Phase 2 STRUCTURE → LaTeX skeleton (book class), figure/table/diagram plan69Phase 3 WRITE → parallel chapter agents, Python charts, BibLaTeX, compile70Phase 4 VISUALISE → TikZ/Mermaid renders, Nano Banana infographic upgrade71Phase 5 REVIEW → 4 specialist reviewers + optional cross-LLM review + optional72 prose-sanitiser de-slop pass73Phase 6 PUBLISH → clean 3-pass build, PDF verify, asset audit, git commit74```7576Per-phase mechanics — swarm topology, report directory layout, chart style,77diagram commands, reviewer roles, the final clean-build script, and quality gates —78are in [`references/pipeline.md`](references/pipeline.md).7980## Quality Gates8182- 0 LaTeX errors83- Every `\includegraphics` resolves to an existing file; no unused generated assets84- PDF renders correctly via PyMuPDF85- UK English throughout (babel british)8687## References8889- [`references/pipeline.md`](references/pipeline.md) — detailed six-phase guide (topology, structure, charts, diagram pipeline, review, final assembly).90- [`references/reference.md`](references/reference.md) — prerequisites, configuration (`report-config.yaml`, colour schemes), skill integration map, troubleshooting, example output, scripts/resources catalog.9192## Scripts9394| Script | Purpose |95|--------|---------|96| `report-preflight` | Check all prerequisites and API keys |97| `scripts/compile_report.sh` | Full LaTeX build pipeline with verification |98| `scripts/asset_audit.sh` | Check all figures referenced and present |99100See [`references/reference.md`](references/reference.md#scripts-reference) for the full script and resource catalog (including templates and figure/pipeline generators).
dreamlab-ai