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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-11
Run: §27365547349

This automated GEO (Generative Engine Optimization) audit evaluated AI-engine citation readiness for the project homepage and documentation site. Both targets are in the Foundation band — accessible to AI crawlers, but missing key signals that enable citations in ChatGPT, Perplexity, and Google AI Overviews.

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	42/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Sitemap avg (20/188 pages audited)	31.65/100	Critical

---

✅ Top Strengths

• Comprehensive llms.txt on README — 2,919 words, 12 sections, 117 links (14/18). Excellent LLM-friendly project summary.
• Extensive AI bot permissions — GitHub's robots.txt explicitly allows 27 AI crawlers including GPTBot, ClaudeBot, PerplexityBot, Google-Extended (15/18). No bots are blocked.
• Perfect meta tags on docs site — Title, description, canonical, Open Graph title/description/image all present (14/14).
• Rich schema markup on docs site — WebSite, Organization, SoftwareApplication, and FAQPage JSON-LD schemas (12/16). FAQPage depth of 4 boosts Q&A-style citations.
• Strong signals on docs site — Language tag, RSS feed (/blog/rss.xml), and freshness date all present (6/6).
• Google AI Overviews score 80/100 on docs site — solid meta + schema combination already meets Google's AI requirements.

---

🚨 Critical Gaps

1. No robots.txt on docs site (0/18) — github.github.com/gh-aw has no robots.txt. AI crawlers receive no explicit permission signals. This affects all 188 sitemap pages — every page scores 0 on this dimension.

2. No llms.txt on docs site (0/18) — The docs site has no LLM-friendly structured summary. The README has one; the docs site needs its own at https://github.github.com/gh-aw/llms.txt.

3. Zero AI discovery endpoints (0/6 on both targets) — Neither site exposes /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json.

4. No JSON-LD schema on README/GitHub page (0/16) — GitHub's repo page injects no structured data (WebSite, Organization, FAQPage). This is partially outside the project's direct control.

5. Keyword stuffing penalties — github at 2.8% density on docs site; issue at 22.2% on README (driven by GitHub UI boilerplate). Both trigger a -3 negative score penalty.

6. Sitemap-wide Critical band — 19 of 20 audited pages score Critical (27–33/100). Root cause: missing robots.txt and llms.txt cascade to every page.

---

🔧 Recommended Fixes

Ordered by estimated impact:

Priority	Fix	Est. Points	Scope
🔴 1	Add robots.txt to github.github.com/gh-aw allowing AI crawlers	+18/page	All 188 pages
🔴 2	Create /llms.txt for docs site: gh aw geo llms --base-url https://github.github.com/gh-aw	+18	Docs homepage
🔴 3	Create /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json	+6/page	All pages
🟡 4	Add WebApp JSON-LD type to docs site schema (currently missing)	+4	Docs homepage
🟡 5	Align schema description with meta description on docs site	+2	Docs homepage
🟡 6	Add /about page link on docs site for identity trust	signal	Docs homepage
🟡 7	Add dateModified schema + RSS <link> tag to README	+3	README
🟡 8	Add sameAs KG pillar links to README Organization schema (Wikipedia, Wikidata, LinkedIn, Crunchbase)	+4–7	README
🟢 9	Add numerical statistics to docs site content (has_numbers is false; content score 7/12)	+2	Docs homepage
🟢 10	Add canonical <link> tag to README page (missing — may cause duplicate indexing)	+3	README

📋 Full Category Breakdown

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

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	✅ 949 words, 29 headings; no numbers
Signals	6	6	✅ lang=en, RSS, freshness date
AI Discovery	0	6	❌ No endpoints
Brand & Entity	6	10	✅ 2/4 KG pillars (LinkedIn, Wikidata)
Negative penalty	-3	—	⚠️ Keyword stuffing (github 2.8%), hidden text

Trust Stack: C (15/25) — Technical 3/5, Identity 3/5, Social 4/5, Academic 1/5, Consistency 4/5
Platform Citation Scores: ChatGPT 50, Perplexity 65, Google AI Overviews 80
Negative signals: Keyword stuffing (github 2.8%), hidden text (CtrlK with display:none)

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

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 schema (GitHub page limitation)
Meta Tags	11	14	✅ No canonical URL
Content	12	12	✅ Perfect — 3,102 words, numbers, lists, front-loaded
Signals	3	6	⚠️ lang=en only; no RSS, no freshness date
AI Discovery	0	6	❌ No endpoints
Brand & Entity	3	10	⚠️ No KG pillar links
Negative penalty	-3	—	⚠️ Keyword stuffing (issue 22.2%), 12 broken links, popup signals

Trust Stack: C (16/25) — Technical 5/5 (perfect!), Identity 3/5, Social 1/5, Academic 4/5, Consistency 3/5
Platform Citation Scores: ChatGPT 55, Perplexity 70, Google AI Overviews 48
Content decay risk: HIGH (evergreen score 30/100) — 10 temporal/version signals detected

📄 Sitemap Page Scores (20 of 188 audited)

URL	Score	Band
.../	42	Foundation
.../blog	33	Critical
.../blog/3, /blog/4, /blog/8	33	Critical
.../blog/2, /blog/5, /blog/6	32	Critical
.../blog/continuous-refactoring	32	Critical
.../blog/7	31	Critical
.../blog/9, /blog/welcome-*, /blog/advanced-analytics, /blog/campaigns	30	Critical
.../blog/continuous-simplicity, /blog/continuous-style, /blog/creative-culture, /blog/documentation	30	Critical
.../agent-factory-status	27	Critical (worst)

Root cause: Every page scores 0 on Robots.txt and llms.txt (site-wide gaps). Adding robots.txt and llms.txt to the docs site would immediately lift all 188 pages by up to 36 points.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · ⌖ 13.9 AIC · ⊞ 17.1K · ◷

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