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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-16
Run: §27637736325

---

📊 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 pages)	31.65/100	Critical

---

✅ Top Strengths

Docs site:

• Perfect meta tags (14/14) — title, description, canonical, Open Graph all present
• Strong freshness signals (6/6) — RSS feed + lastmod freshness date (2026-05-09)
• Rich Schema JSON-LD (12/16) — WebSite, Organization, SoftwareApplication, and FAQPage types implemented
• Brand/entity anchors — Wikidata and LinkedIn sameAs links for Knowledge Graph disambiguation

README:

• Excellent robots.txt (15/18) — 27 AI bots explicitly allowed including GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Amazonbot, xAI-Bot
• Well-structured llms.txt (14/18) — 2,919 words, 12 sections, 117 links, H1 + description present
• Full content score (12/12) — rich heading hierarchy, lists/tables, front-loaded key info
• Good meta tags (11/14) — title, description, and Open Graph all present

---

🚨 Critical Gaps

1. Docs site missing robots.txt and llms.txt (0/18 each) — AI crawlers have no explicit permission or structured summary for github.github.com/gh-aw/. ChatGPT and PerplexityBot are effectively gated out.
2. README missing all Schema JSON-LD (0/16) — No WebSite, Organization, or FAQPage structured data on the GitHub repo page. Google AI Overviews, Perplexity, and ChatGPT all use this for entity disambiguation.
3. AI discovery endpoints missing on both targets (0/6 each) — No /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json on either target.
4. Sitemap-wide GEO score is Critical (avg 31.65/100) — 19 of 20 audited pages score in the Critical band, meaning blog posts and docs pages are nearly invisible to AI engines.
5. README negative signals — 12 broken links detected, popup signals present, and keyword issue stuffed at 23.2% density. Hidden text (display:none) penalized on both targets.

---

🔧 Recommended Fixes

Ordered by estimated impact:

1. [High] Add robots.txt to the docs site with Allow rules for GPTBot, ClaudeBot, PerplexityBot, Google-Extended. Use: gh aw compile to validate. Template:

   User-agent: GPTBot
   Allow: /
   User-agent: ClaudeBot
   Allow: /
   User-agent: PerplexityBot
   Allow: /
   User-agent: Google-Extended
   Allow: /
   

2. [High] Generate llms.txt for the docs site — run geo llms --base-url https://github.github.com/gh-aw and commit to repo root. Unlocks 18 points.
3. [High] Add JSON-LD schema to the README / GitHub repo page — WebSite, Organization (with sameAs to Wikipedia, Wikidata, LinkedIn), and FAQPage. This is a 16-point gap on the README.
4. [High] Create AI discovery endpoints on the docs site: /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json. Each unlocks structured citation pathways (6 points per target).
5. [Medium] Fix README broken links — 12 broken links detected; broken links are a negative signal for AI crawlers and lower citability.
6. [Medium] Add stats and numbers to the docs site homepage — current numbers_count: 0. Concrete metrics (e.g., "compiles in <2s", "supports 10+ workflow types") significantly boost AI snippet selection.
7. [Medium] Add sameAs links to docs site — connect to Wikipedia (project page) and Crunchbase; currently only 2/4 KG pillars present.
8. [Low] Diversify keyword density — issue at 23.2% on README; github at 2.8% on docs site. Broaden vocabulary.
9. [Low] Add WebMCP tool attributes to interactive elements on the docs site for Chrome AI agent compatibility.
10. [Low] Add VideoObject schema — video content detected on docs site without schema markup.

📋 Full Breakdown by Category

Category	Docs Site Score	Docs Site Max	README Score	README Max
Robots.txt	0	18	15	18
llms.txt	0	18	14	18
Schema JSON-LD	12	16	0	16
Meta Tags	14	14	11	14
Content	7	12	12	12
Signals	6	6	3	6
AI Discovery	0	6	0	6
Brand & Entity	6	10	3	10
Negative Penalty	-3	—	-3	—
Total	42	100	55	100

Docs site negative signals (medium severity): keyword stuffing (github at 2.8%), hidden text (display:none)

README negative signals (medium severity): 12 broken links, popup signals, keyword stuffing (issue at 23.2%), hidden text

Platform citation scores (Docs site):

• ChatGPT: 50/100 — FAQPage schema & citability (81/100) are strengths; missing robots.txt/llms.txt are blockers
• Perplexity: 65/100 — High citability (81/100), RSS feed, and content freshness; blocked by missing robots.txt/llms.txt
• Google AI: 80/100 — Complete meta tags, OG tags, and strong citability; needs more schema types

WebMCP readiness (Docs site): basic — SearchAction present but no tool attributes, no labeled forms

📄 Sitemap Page Scores (top 5 of 20 audited, 188 total discovered)

Score	Band	URL
42	foundation	https://github.github.com/gh-aw
33	critical	https://github.github.com/gh-aw/blog
33	critical	https://github.github.com/gh-aw/blog/3
33	critical	https://github.github.com/gh-aw/blog/4
33	critical	https://github.github.com/gh-aw/blog/5

Average across 20 pages: 31.65/100 (Critical band)
Band distribution: 1 Foundation, 19 Critical

All non-homepage pages score 0 on robots, llms, schema, and AI discovery — indicating the gaps are systemic across the entire docs site.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · ◷

• expires on Jun 19, 2026, 10:10 AM UTC-08:00