hermeticormus GEO client report generator
Aggregates outputs from the geo-* audit family into one report for business owners and marketing leaders (not developers). Technical findings translate into business impact and prioritized actions.
How to use
- Run (or collect existing output of) these audits:
geo-platform-optimizer→ GEO-PLATFORM-OPTIMIZATION.mdgeo-schema→ GEO-SCHEMA-REPORT.mdgeo-technical→ GEO-TECHNICAL-AUDIT.mdgeo-content→ GEO-CONTENT-ANALYSIS.md- (Optional)
geo-llms-txt→ llms.txt assessment - (Optional)
geo-brand-mentions→ brand authority data
- Collect all scores and findings
- Calculate the composite GEO Readiness Score (formula below)
- Generate the report using the 12-section template in
template.md - Output: GEO-CLIENT-REPORT.md
GEO readiness score
Component weights
| Component | Weight | Source skill |
|---|---|---|
| AI Platform Readiness | 25% | geo-platform-optimizer |
| Content Quality & E-E-A-T | 25% | geo-content |
| Technical Foundation | 20% | geo-technical |
| Schema & Structured Data | 15% | geo-schema |
| Brand Authority & Entity Presence | 15% | geo-platform-optimizer (entity signals) |
Formula
GEO Score = (Platform Score * 0.25) + (Content Score * 0.25) + (Technical Score * 0.20) + (Schema Score * 0.15) + (Brand Score * 0.15)
Round to the nearest integer. Cap at 100.
Score interpretation
| Range | Label | Client-facing description |
|---|---|---|
| 85-100 | Excellent | Your site is well-positioned for AI search. Focus on maintaining and expanding your advantage. |
| 70-84 | Good | Solid foundation with clear opportunities to improve AI visibility. Targeted optimizations will yield significant results. |
| 55-69 | Moderate | Your site has gaps in AI readiness that competitors may be exploiting. A structured optimization plan will close these gaps. |
| 40-54 | Below Average | Significant barriers to AI search visibility exist. Without action, your brand risks being invisible in AI-generated answers. |
| 0-39 | Needs Attention | Critical AI readiness issues require immediate action. Your competitors are likely capturing the AI search traffic your brand should own. |
Report structure
The 12-section template lives in template.md. Fill each section with actual audit data.
- Executive summary (one paragraph)
- GEO readiness score (overall + component table)
- AI visibility dashboard (per-platform readiness)
- AI crawler access status (robots.txt by bot)
- Brand authority analysis (entity presence across platforms)
- Citability analysis (top 5 most + least citable pages)
- Technical health summary
- Schema and structured data
- llms.txt status
- Prioritized action plan (Quick Wins / Medium-Term / Strategic) — bucket criteria + examples in
examples.md - Competitor comparison (if URLs provided)
- Appendix (methodology, data sources, glossary)
Tone and formatting
- Markdown throughout: tables for data, bullets for recommendations, bold sparingly for key terms
- One blank line between sections;
---separators between major sections - All URLs absolute
- Written for business owners — confident, direct, action-oriented
- Every finding connects to a specific action
- Translate technical issues into business outcomes
- Avoid: jargon without explanation, hedging, passive voice, excessive caveats
- Use: "Your site [does/does not]...", "We recommend...", "This impacts..."
- Dollar-value framing: conservative estimates, state assumptions, never guarantee results (examples in
examples.md)
Output
GEO-CLIENT-REPORT.md — filled template, 3,000-6,000 words, ready to send to a client without editing, self-contained (no references to other report files).