[geo-optimizer] GEO Audit Report — 2026-07-11

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-11
Run: §29160114585

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	43/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Sitemap average (20 pages)	36.45/100	Foundation/Critical

---

✅ Top Strengths

• README robots.txt & llms.txt — README scores 15/20 on robots and 14/20 on llms.txt; AI crawlers are allowed and a structured llms.txt is present.
• Meta tags on docs site — Docs homepage achieves 14/20 on meta tags, the best-covered category site-wide.
• Content depth — README content score 12/20 indicates substantive, non-thin content.
• Author signal — README has author attribution, a positive trust signal for AI engines.
• Schema on docs homepage — Schema JSON-LD score of 12/20 on the docs homepage is the highest across audited pages.

---

🚨 Critical Gaps

1. Zero AI Discovery score (0/20) everywhere — No /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json on the docs site.
2. Zero robots.txt & llms.txt on docs site (0/20 each) — No robots.txt allowing AI bots (GPTBot, ClaudeBot, PerplexityBot) and no llms.txt on github.github.com/gh-aw/.
3. Zero JSON-LD schema on README (0/20) — No WebSite, Organization, or FAQPage structured data on the GitHub repository homepage.
4. Hidden text detected — Both targets have display:none/visibility:hidden content that AI crawlers may flag as a cloaking penalty (-3 pts each).
5. 13 broken links on README plus keyword stuffing (github at 2.7–2.8% density) generating negative score penalties.

---

🔧 Recommended Fixes

Ordered by estimated score impact:

1. Add robots.txt to docs site with AI bot allow rules — Explicit Allow directives for GPTBot, ClaudeBot, PerplexityBot. Est. +10–15 pts docs site.
2. Create /llms.txt on docs site — Run geo llms --base-url https://github.github.com/gh-aw. Est. +10–14 pts docs site.
3. Create AI discovery endpoints — Add /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json. Est. +10–15 pts on all pages.
4. Add JSON-LD schema to README — Add WebSite + Organization schema with sameAs links. Est. +15–20 pts on README.
5. Fix broken links in README — 13 broken links generate negative penalties; audit and remove/update them.
6. Remove or restructure hidden text — Refactor display:none content to avoid cloaking penalty.
7. Reduce keyword density for github — Diversify vocabulary to drop below 2%.

📋 Full Score Breakdown by Category

Docs Site (github.github.com/gh-aw/)

Category	Score
Robots.txt	0/20
llms.txt	0/20
Schema JSON-LD	12/20
Meta Tags	14/20
Content	7/20
Brand & Entity	7/20
Signals	6/20
AI Discovery	0/20
Negative Penalty	-3
Total	43/100

README (github.com/github/gh-aw)

Category	Score
Robots.txt	15/20
llms.txt	14/20
Schema JSON-LD	0/20
Meta Tags	11/20
Content	12/20
Brand & Entity	3/20
Signals	3/20
AI Discovery	0/20
Negative Penalty	-3
Total	55/100

Negative Signals (README)

• Hidden text: yes
• Keyword stuffing (github at 2.7%): yes
• Broken links: 13
• Popup signals detected: yes

📄 Sitemap Page Scores (top & worst)

Top pages (by score):

URL	Score	Band
.../blog/2026-01-13-meet-the-workflows-continuous-improvement	44	Foundation
github.github.com/gh-aw (homepage)	43	Foundation
.../blog/2026-01-13-meet-the-workflows-continuous-refactoring	43	Foundation

Worst pages (by score):

URL	Score	Band
.../blog/10	30	Critical
.../blog/8	31	Critical
.../blog/7	32	Critical

Band distribution: 11 Critical, 9 Foundation (0 Good, 0 Excellent out of 20 pages audited)

---

Automated audit powered by geo-optimizer-skill · Run logs

Generated by 🌍 GEO Optimizer Daily Audit · 26 AIC · ⌖ 13.5 AIC · ⊞ 5K · ◷

• expires on Jul 14, 2026, 8:44 AM UTC-08:00