---
name: seo-audit-report
description: Compile all SEO audit data into a professional HTML report. Reads CSV/JSON from crawl, hreflang, meta, schema, images, keywords, GSC, GA, and performance skills.
disable-model-invocation: true
argument-hint: "[data-dir] [client-name] [sites...]"
---

# SEO Audit: Report Compilation

Compile all audit data into a professional HTML report.

## Input data (in `$0` directory):
Read all CSV and JSON files produced by the other audit skills:
- `*_sitemap_check.csv` — Sitemap URL status
- `*_broken_links.csv` — Broken internal links
- `*_hreflang.csv` — Hreflang tags and alternate URL status
- `*_meta.csv` and `*_meta_issues.csv` — Page titles, descriptions, H1s, word counts
- `*_schema.csv` — JSON-LD structured data
- `*_images.csv` — Image alt text status
- `*_ai_crawlers.csv` — AI crawler access
- Any keyword ranking CSVs
- Any GSC/GA reports

## Output:
Write a clean, professional HTML report.

## Report structure:
1. Cover/hero with client name and scores
2. Executive summary with top findings
3. Keyword rankings & market opportunity (from keyword data)
4. SEO health scores by category
5. Critical issues
6. High priority issues
7. Content & E-E-A-T analysis (from meta data)
8. Technical SEO (from crawl, hreflang, sitemap data)
9. Performance & Core Web Vitals
10. Schema & structured data
11. AI search readiness (from AI crawler data)
12. Image optimization (from image data)
13. Quick wins with effort/impact matrix
14. Action plan & roadmap
15. Appendix with raw data tables

## Important:
- All data claims must come from the CSV/JSON files — do NOT make up numbers
- Use color-coded severity badges: critical (red), high (orange), medium (yellow), low (blue)
- Include data tables so the reader can verify the findings
