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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-05-11
Run: §25685332477

---

📊 Scores

Target	Score	Band	Citability
Docs site (github.github.com/gh-aw/)	38/100	Foundation	84/100
README (github.com/github/gh-aw)	55/100	Foundation	84/100
Sitemap audit	❌ N/A	—	404: sitemap.xml not found

Both targets are in the Foundation band, meaning the basics are in place but significant gaps exist in AI-specific discoverability signals. Core content quality is strong (84/100 citability on both), but infrastructure for AI crawlers is incomplete.

---

✅ Top Strengths

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

• 🏆 Perfect meta tags (14/14) — title, description, canonical, Open Graph all present
• 🏆 Perfect signals (6/6) — language declared, RSS feed linked, freshness date present (2026-05-09)
• 📖 Rich Schema JSON-LD — WebSite, Organization, SoftwareApplication, and FAQPage types detected
• ⚡ No JS dependency — 1,206 words and 26 headings accessible in raw HTML (Astro framework)
• 🤖 Instruction readiness: advanced (score 90/100) — all buttons and forms labeled

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

• 🏆 Comprehensive robots.txt (15/18) — 27 AI bots explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Bingbot, and more)
• 📄 Strong llms.txt (14/18) — 2,873 words, 11 sections, 117 links — well-structured LLM summary
• 🏆 Perfect content score (12/12) — 472 numbers cited, strong heading hierarchy, front-loaded content
• 🔒 Full technical trust (5/5) — HTTPS, HSTS, CSP, and X-Frame-Options all present

---

🚨 Critical Gaps

1. Docs site has no robots.txt (0/18) — AI crawlers (GPTBot, ClaudeBot, PerplexityBot) are not explicitly allowed on github.github.com/gh-aw/. Without this, crawlers may be uncertain about access.

2. Docs site has no llms.txt (0/18) — The docs site is missing the LLM-friendly summary file that the README already has. This is a direct gap in structured AI discoverability.

3. AI Discovery endpoints missing on both targets (0/6 each) — Neither site has:

   • /.well-known/ai.txt
   • /ai/summary.json
   • /ai/faq.json
   • /ai/service.json

4. README has no Schema JSON-LD (0/16) — The GitHub.com repository page lacks structured data (WebSite, Organization, FAQPage). This is a GitHub platform limitation, but worth noting as it severely limits Google AI Overview and knowledge graph inclusion.

5. Brand & entity signals weak on both (3/10 each) — No Wikipedia, Wikidata, LinkedIn, or Crunchbase sameAs links in schema; no Knowledge Graph pillar URLs.

---

🔧 Recommended Fixes

Ordered by impact vs. effort:

Priority	Fix	Target	Impact
🔴 P1	Create robots.txt on docs site allowing AI bots	Docs site	Robots: 0 → 18 pts
🔴 P1	Create /llms.txt on docs site (geo llms --base-url https://github.github.com/gh-aw)	Docs site	llms.txt: 0 → ~14 pts
🟠 P2	Create /.well-known/ai.txt on docs site	Docs site	AI discovery: +2 pts
🟠 P2	Create /ai/summary.json, /ai/faq.json, /ai/service.json on docs site	Docs site	AI discovery: 0 → 6 pts
🟠 P2	Fix docs site sitemap (/sitemap.xml returns 404) to enable sitemap auditing	Docs site	Sitemap coverage
🟡 P3	Add sameAs links (Wikipedia/Wikidata/LinkedIn) to Organization schema on docs site	Docs site	Brand/entity: +3 pts
🟡 P3	Fix docs site Schema JSON-LD: add @context to WebSite, Organization, and FAQPage schemas	Docs site	Schema: 7 → 12+ pts
🟡 P3	Add dateModified schema to README page	README	Signals: +1-2 pts
🟡 P3	Add canonical <link rel="canonical"> to README page	README	Meta: +1 pt
🔵 P4	Reduce keyword density of 'github' (3.7%) on docs site — diversify vocabulary	Docs site	Negative penalty
🔵 P4	Add WebApp / SoftwareApplication schema with potentialAction to docs site	Docs site	WebMCP readiness

📋 Full Breakdown by Category — Docs Site (38/100)

Category	Score	Max	Status
robots.txt	0	18	❌ File not found
llms.txt	0	18	❌ File not found
Schema JSON-LD	7	16	⚠️ Missing @context fields; no WebApp schema
Meta Tags	14	14	✅ Perfect
Content	11	12	✅ Missing numerical statistics
Signals	6	6	✅ Perfect
AI Discovery	0	6	❌ No well-known, summary, faq, or service endpoints
Brand & Entity	3	10	⚠️ No KG pillar links, no about/contact in schema
Negative Penalty	-3	—	⚠️ Hidden text (CtrlK shortcut), keyword stuffing

Trust Stack: Grade C (medium) — Technical: 3/5, Identity: 2/5, Social: 3/5, Academic: 1/5, Consistency: 4/5

Platform Citation Scores: ChatGPT 50/100 · Perplexity 65/100 · Google AI 70/100

RAG Readiness: Chunk score 45/100 — avg section 5.9 words (too short); 0/14 sections in optimal range

Prompt Injection: Medium risk — 1 hidden text pattern detected ("CtrlK" from keyboard shortcut UI)

📋 Full Breakdown by Category — README (55/100)

Category	Score	Max	Status
robots.txt	15	18	✅ 27 AI bots allowed; no explicit citation-bot declaration
llms.txt	14	18	✅ Present; missing llms-full.txt and optional sections
Schema JSON-LD	0	16	❌ GitHub.com platform provides no schema markup
Meta Tags	11	14	⚠️ Missing canonical URL
Content	12	12	✅ Perfect
Signals	3	6	⚠️ No RSS feed, no freshness date on page
AI Discovery	0	6	❌ No well-known, summary, faq, or service endpoints
Brand & Entity	3	10	⚠️ No KG pillar links; no social/Wikipedia sameAs
Negative Penalty	-3	—	⚠️ Hidden text (nav), keyword stuffing ('issue' at 21.7%)

Trust Stack: Grade C (medium) — Technical: 5/5, Identity: 3/5, Social: 1/5, Academic: 4/5, Consistency: 3/5

Platform Citation Scores: ChatGPT 55/100 · Perplexity 70/100 · Google AI 45/100

Content Decay Risk: HIGH — evergreen score 30/100; 10 decay signals detected (version numbers, closed issue references, temporal language)

RAG Readiness: Chunk score 46/100 — avg section 23.4 words; heavy GitHub nav boilerplate dilutes content

Prompt Injection: Medium risk — hidden GitHub navigation text detected in display:none elements

📄 Sitemap Audit

https://github.github.com/gh-aw/sitemap.xml returned HTTP 404. No sitemap pages could be audited.

Recommended fix: Configure the Astro Starlight site to generate and serve a sitemap. Starlight supports this via the @astrojs/sitemap integration or Starlight's built-in sitemap support.

---

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

Generated by GEO Optimizer Daily Audit · ● 2.6M · ◷

• expires on May 14, 2026, 5:16 PM UTC