geo-report-pdf

# GEO PDF Report Generator ## Purpose This skill generates a professional, visually polished PDF report from GEO audit data. The PDF includes score gauges, bar charts, platform readiness visualizations, color-coded tables, and a prioritized action plan — ready to deliver directly to clients. > **Two PDF paths — pick one.** For a **branded, client-ready** deliverable, prefer the TypeScript [`tools/audit-report-kit`](../../tools/audit-report-kit) (react-pdf, THL brand tokens, provenance tags, `—` for null scores, compile-checked JSON-LD alongside). The ReportLab script below is the lightweight Python path when you don't want a Node toolchain. They render the same audit JSON; don't run both. ## Prerequisites - **ReportLab** must be installed: `pip install reportlab` - The Python PDF generation script lives at [`../geo/scripts/generate_pdf_report.py`](../geo/scripts/generate_pdf_report.py) (shared with the `geo` umbrella skill). Run it from the repo root: `python3 skills/geo/scripts/generate_pdf_report.py <data.json> <out.pdf>`. - Run a full GEO audit first (using `geo-audit`) to have data to include in the report ## How to Generate a PDF Report ### Step 1: Collect Audit Data After running a full `/geo-audit`, collect all scores, findings, and recommendations into a JSON structure. The JSON data must follow this schema: ```json { "url": "https://example.com", "brand_name": "Example Company", "date": "2026-02-18", "geo_score": 65, "scores": { "...