[geo-optimizer] GEO Audit Report — 2026-06-21

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-21
Run: §27911156199

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	43/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Sitemap avg (20/190 pages sampled)	31.55/100	Critical

---

✅ Top Strengths

1. README robots.txt — 27 AI bots explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and more); score 15/18.
2. README llms.txt — Comprehensive file with 2 919 words, 12 sections, 117 links; score 14/18.
3. Docs site meta tags — Perfect 14/14: title, description, canonical, OG tags all present.
4. Docs site Schema JSON-LD — 12/16: WebSite, Organization, SoftwareApplication, and FAQPage types found.
5. Docs site freshness signals — 6/6: language tag, RSS feed, and dateModified all present.
6. Content accessibility — Both targets serve full content in raw HTML (no JS rendering required) with 900–2 900 words.
7. Platform citation (Perplexity) — Docs site scores 65/100, README 70/100 for Perplexity citation readiness.

---

🚨 Critical Gaps

1. Docs site has no robots.txt — Scores 0/18. AI bots have no explicit permission signal; every one of the 190 sitemap pages inherits this 0.
2. Docs site has no llms.txt — Scores 0/18 on every sampled page (0.0 average across sitemap). This is the highest single-category gap across the entire site.
3. AI Discovery endpoints completely missing — Both targets score 0/6. No /.well-known/ai.txt, no /ai/summary.json, /ai/faq.json, or /ai/service.json on either the docs site or the README.
4. README has zero Schema JSON-LD — Scores 0/16: no WebSite, Organization, SoftwareApplication, or FAQPage markup on github.com/github/gh-aw.
5. Brand & Entity very weak on README — Scores 3/10; no Knowledge Graph pillar links (Wikipedia, Wikidata, LinkedIn, Crunchbase), no contact info in schema.
6. 95% of sitemap pages are Critical — 19 of 20 audited pages score Critical band (avg 31.55); the /about page is the worst at 26/100.
7. Negative signals on both targets — Hidden text (cloaking risk), keyword stuffing (github at 2.8% on docs; issue at 22.5% on README), 12 broken links on the README page.

---

🔧 Recommended Fixes

Ordered by estimated score impact:

Priority	Fix	Estimated Gain	Affects
🔴 1	Add robots.txt to docs site with AI bot Allow rules	+18 pts	All 190 sitemap pages
🔴 2	Create /llms.txt for docs site (geo llms --base-url https://github.github.com/gh-aw)	+18 pts	Docs site & sitemap avg
🟠 3	Add JSON-LD schema to README (WebSite, Organization, FAQPage)	+16 pts	README
🟠 4	Add AI discovery endpoints to docs site: /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json	+6 pts	Docs site
🟠 5	Add AI discovery endpoints to README (GitHub repo-level, e.g. via .well-known in repo root served by Pages)	+6 pts	README
🟡 6	Add sameAs KG pillar links to README schema (Wikipedia, Wikidata, LinkedIn, Crunchbase)	+up to 7 pts	README brand & entity
🟡 7	Add <link rel="canonical"> to README page	+3 pts	README meta
🟡 8	Add VideoObject schema to docs site (2 videos detected without schema)	+2–4 pts	Docs site
🟢 9	Add numerical stats/concrete data to docs site content (currently 0 numbers)	incremental	Docs site content
🟢 10	Fix keyword stuffing: diversify vocabulary on docs site (github 2.8%) and README (issue 22.5%)	removes -3 penalty	Both

📋 Full Breakdown by Category

Docs Site — github.github.com/gh-aw/ (score: 43/100)

Category	Score	Max	Status
Robots.txt	0	18	❌ Not found
llms.txt	0	18	❌ Not found
Schema JSON-LD	12	16	✅ WebSite, Organization, SoftwareApplication, FAQPage
Meta Tags	14	14	✅ Perfect
Content	7	12	⚠️ No numbers, no lists/tables, no front-loading
Signals	6	6	✅ lang=en, RSS, freshness date
AI Discovery	0	6	❌ No well-known/ai.txt, no /ai/* endpoints
Brand & Entity	7	10	⚠️ No about link, schema desc ≠ meta desc
Negative penalty	-3	—	⚠️ Hidden text, keyword stuffing (github 2.8%)

Trust stack: C (15/25) — Social trust 4/5 (KG pillars via org), Academic trust 1/5 (no stats)
WebMCP: basic — not agent-ready, no tool attributes
Multimodal: good — 100% alt coverage, 2 videos (no VideoObject schema)
Platform citations: ChatGPT 50, Perplexity 65, Google AI 80

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

Category	Score	Max	Status
Robots.txt	15	18	✅ 27 AI bots allowed
llms.txt	14	18	✅ 2 919 words, 12 sections, 117 links
Schema JSON-LD	0	16	❌ No types found
Meta Tags	11	14	⚠️ Missing canonical URL
Content	12	12	✅ Perfect — 2 894 words, numbers, lists, front-loaded
Signals	3	6	⚠️ Has lang, no RSS, no freshness date
AI Discovery	0	6	❌ No well-known/ai.txt, no /ai/* endpoints
Brand & Entity	3	10	❌ No KG pillars, no contact info in schema
Negative penalty	-3	—	⚠️ Hidden text, keyword stuffing (issue 22.5%), 12 broken links

Trust stack: C (16/25) — Technical 5/5, Academic 4/5, Social 1/5
Content decay risk: high — version numbers and dates will go stale
Platform citations: ChatGPT 55, Perplexity 70, Google AI 48

📄 Sitemap Page Scores (20 of 190 audited)

URL	Score	Band
/ (homepage)	43	Foundation
/blog	33	Critical
/blog/3–5	33	Critical
/blog/2026-01-13-...-continuous-improvement	33	Critical
/blog/2026-01-13-...-continuous-refactoring	32	Critical
/blog/2, /blog/6	32	Critical
/blog/7, /blog/9	30	Critical
/blog/2026-01-13-...-* (multiple)	30	Critical
/agent-factory-status	28	Critical
/about	26	Critical

Common pattern across all pages: robots=0, llms=0, ai_discovery=0. Meta tags are consistently 14/14 (strength). Schema is 0 on all non-homepage pages.

190 URLs discovered in sitemap; cap was 20. Re-run with --max-urls to audit more.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 26.7 AIC · ⌖ 8.03 AIC · ⊞ 4.5K · ◷

• expires on Jun 24, 2026, 9:00 AM UTC-08:00

[pelikhan]

/plan

[github-actions[bot]]

🚀 Workflow has started processing this discussion comment