Skip to content

Reports

FAT Agent generates several report formats for different audiences: Word documents, PowerPoint presentations, SVG badges, and charts.

Word Document Report

python scripts/generate-report.py \
  --scores scores.json \
  --format docx \
  --output report.docx

The Word report includes:

  • Executive summary with overall score and grade
  • Category breakdowns with detailed scores
  • Full findings list organised by priority
  • Recommended fix actions with effort estimates
  • Appendix with raw analysis data

PowerPoint Presentation

python scripts/generate-report.py \
  --scores scores.json \
  --format pptx \
  --output presentation.pptx

The presentation includes:

  • Title slide with site name and date
  • Score overview slide with grade visualisation
  • One slide per category with key findings
  • Priority breakdown slide
  • Next steps and recommendations slide

SVG Badge

# Overall score badge
python scripts/generate-badge.py scores.json --output badge.svg

# Category-specific badge
python scripts/generate-badge.py scores.json --category seo --output seo-badge.svg

Badges use the standard shields.io style and are suitable for README files:

  • Green for A grade (90+)
  • Blue for B grade (80+)
  • Yellow for C grade (70+)
  • Orange for D grade (60+)
  • Red for F grade (<60)

Charts

python scripts/generate-charts.py \
  --scores scores.json \
  --output-dir ./charts

Generates SVG charts:

  • Radar chart -- all category scores on a spider diagram
  • Bar chart -- category comparison
  • Priority distribution -- pie chart of findings by priority

Historical Tracking

FAT Agent supports historical audit tracking. Save scores from each audit run and compare over time:

You: Compare this audit with the previous one
You: Show me the score trend for the last 5 audits

Claude will load previous score files and highlight improvements and regressions.

Report Options

Flag Description
--format Output format: docx, pptx, html
--output Output file path
--client-facing Use plain English mode
--title Custom report title
--logo Path to logo image for the report header