geo-report
Skill1 starsChanged 43 days agoMITView on GitHub
Client-facing GEO report generator that combines audit results into one Markdown deliverable with a GEO readiness score, findings, and an action plan in quick wins, medium-term, and strategic buckets. Use after an audit when the user wants a report to hand to a client or stakeholder.
6 other projects use a version of this, 4 of them edited.
Adopted by
Most recently taken up by
- alpit-patel/seo-aeo-geo-kitedited, first seen Nov 8, 2026
- DoddleHQ/doddle-seo-geo-skillstheir own version, first seen Oct 20, 2026
- techhorizonlabs/thl-openedited, first seen Oct 9, 2026
- HermeticOrmus/LibreGEO-Claude-Codeword for word, first seen Oct 1, 2026
- zubair-trabzada/geo-seo-claudeedited, first seen Aug 4, 2026
- kennyolofsson23-netizen/claude-code-configedited, first seen Mar 16, 2026
Other versions6 projects use a version of this.
Word for word · 1
- HermeticOrmus/LibreGEO-Claude-Code★ 1100% same
Edited · 4
- zubair-trabzada/geo-seo-claude★ 11k12% same
- techhorizonlabs/thl-open★ 1612% same
- alpit-patel/seo-aeo-geo-kit★ 212% same
- kennyolofsson23-netizen/claude-code-config★ 013% same
Wrote their own version · 1
- DoddleHQ/doddle-seo-geo-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository11 other files it gives its agents.
- geo-auditSkill
- geo-brand-mentionsSkill
- geo-citabilitySkill
- geo-contentSkill
- geo-crawlersSkill
- geo-llmstxtSkill
- geo-platform-optimizerSkill
- geo-report-pdfSkill
- geo-schemaSkill
- geoSkill
- geo-technicalSkill
The file
We split this skill into the rules it gives an agent
4 rules. 2 are common, 2 are distinctive, and 0 are very specific to this project.
2
Common
Most of the 5 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 15
Run (or collect existing output of) these audits:
- Distinctive: line 86
Every finding connects to a specific action
- Common: line 88
Avoid: jargon without explanation, hedging, passive voice, excessive caveats
- Common: line 89
Use: "Your site [does/does not]...", "We recommend...", "This impacts..."
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.