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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-22
Run: §29939896039

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	44/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation

All sitemap pages also scored in the Foundation band (36–44/100), indicating site-wide gaps rather than isolated issues.

---

✅ Top Strengths

• Docs site meta tags — Full score (14/14): title, description, canonical, OG tags all present and well-formed
• Docs site schema/JSON-LD — 13/16: WebSite, Organization, SoftwareApplication, and FAQPage types all implemented
• Docs site signals — Full score (6/6): lang="en", RSS feed, and freshness date all present
• Docs site brand & entity — 7/10: Brand name consistent, Knowledge Graph pillars (Wikipedia, Wikidata, LinkedIn, Crunchbase) all linked
• README robots.txt — 15/18: 27 AI bots explicitly allowed including GPTBot, ClaudeBot, PerplexityBot, Google-Extended
• README llms.txt — 14/18: Present with H1, description, 12 sections, 117 links, 2919 words

---

🚨 Critical Gaps

1. Docs site missing robots.txt (0/18) — No robots.txt at github.github.com/gh-aw/ means AI bots have no explicit permission signal. This is a full 18-point gap.
2. Docs site missing llms.txt (0/18) — No /llms.txt file for the docs site. Another full 18-point gap.
3. Docs site missing AI discovery endpoints (0/6) — No /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json.
4. README has zero JSON-LD schema (0/16) — The GitHub repository page has no structured data (WebSite, Organization, FAQPage schemas).
5. Docs site hidden text — display:none/visibility:hidden content detected; AI crawlers may penalize as cloaking.
6. README 13 broken links — Broken links degrade crawlability and trustworthiness signals.

---

🔧 Recommended Fixes

Priority	Fix	Est. Impact
🔴 P1	Add robots.txt to docs site with AI bot Allow rules	+18 pts
🔴 P1	Create /llms.txt for docs site (geo llms --base-url https://github.github.com/gh-aw)	+18 pts
🟠 P2	Add /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json to docs site	+6 pts
🟠 P2	Fix README JSON-LD: add WebSite, Organization, and FAQPage schemas	+16 pts
🟡 P3	Fix 13 broken links in README	signal quality
🟡 P3	Add canonical <link> to README/GitHub page	+3 pts
🟡 P3	Front-load key information in first 30% of docs site content	snippet selection
🟡 P3	Add concrete numerical statistics to docs site content	+AI visibility
🟡 P4	Remove or restructure hidden text on docs site	cloaking penalty
🟡 P4	Diversify keyword usage (github at 2.8% density on docs site — reduce stuffing)	quality signal

📋 Full Breakdown by Category

Docs Site (github.github.com/gh-aw/) — 44/100

Category	Score	Max	Status
Robots.txt	0	18	❌ Missing
llms.txt	0	18	❌ Missing
Schema JSON-LD	13	16	✅ WebSite, Organization, SoftwareApplication, FAQPage
Meta Tags	14	14	✅ Full score
Content	7	12	⚠️ No numbers/stats, no front-loading, no lists/tables
Brand & Entity	7	10	✅ KG pillars present; missing about link, recent articles
Signals	6	6	✅ Full score
AI Discovery	0	6	❌ No well-known/ai.txt or JSON endpoints

Negative signals: keyword stuffing (github 2.8%), hidden text detected, no author signal

README (github.com/github/gh-aw) — 55/100

Category	Score	Max	Status
Robots.txt	15	18	✅ 27 AI bots allowed
llms.txt	14	18	✅ Present, well-structured
Schema JSON-LD	0	16	❌ No structured data
Meta Tags	11	14	⚠️ Missing canonical URL
Content	12	12	✅ Full score
Brand & Entity	3	10	❌ No KG pillars, no schema sameAs
Signals	3	6	⚠️ No RSS, no freshness date
AI Discovery	0	6	❌ No AI discovery endpoints

Negative signals: hidden text, popup signals, 13 broken links, boilerplate ratio 0.19

📄 Sitemap Page Scores

Page	Score	Band
github.github.com/gh-aw (home)	44	Foundation
blog: continuous-improvement	44	Foundation
blog: continuous-refactoring	43	Foundation
blog: welcome-to-pelis-agent-factory	41	Foundation
blog: advanced-analytics	41	Foundation
blog: campaigns	41	Foundation
blog: continuous-simplicity	41	Foundation
blog: continuous-style	41	Foundation
agent-factory-status	37	Foundation
blog (index)	36	Foundation

All pages are in the Foundation band. The robots.txt and llms.txt gaps affect every page since these are site-wide files.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · sonnet46 21.8 AIC · ⌖ 9.86 AIC · ⊞ 5K · ◷

• expires on Jul 25, 2026, 8:58 AM UTC-08:00