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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-26
Run: §30210865953

---

📊 Scores

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

Both targets fall in the Foundation band, indicating significant room for improvement before AI engines will reliably cite or surface this project.

---

✅ Top Strengths

• README robots.txt — Scores 15/100 (highest in the README audit), indicating some allowance for AI crawlers is already in place.
• README llms.txt — Score 14/100; an llms.txt file exists for the README target, giving AI systems a structured signal.
• README meta tags — Score 11/100; basic Open Graph / meta-description coverage is present.
• README content — Score 12/100; content is not thin and includes author signals.
• Docs site meta tags — Score 14/100; the docs site has reasonable meta tag coverage relative to other categories.

---

🚨 Critical Gaps

1. AI Discovery files missing on both targets (0/100) — Neither /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, nor /ai/service.json exist. These are the primary signals AI engines use to discover and describe a service.
2. Docs site has no robots.txt or llms.txt (0/100 each) — AI crawlers like GPTBot, ClaudeBot, and PerplexityBot have no explicit permission or guidance for github.github.com/gh-aw/.
3. Schema/JSON-LD completely absent from the README (0/100) — No WebSite, Organization, or FAQPage structured data is present, preventing Knowledge Graph disambiguation.
4. Docs site Schema/JSON-LD is minimal (13/100) — The docs site lacks Organization, FAQPage, and VideoObject schema despite having video content.
5. Brand & Entity signals are very weak — README scores 3/100 and docs site 7/100. No sameAs links to Wikipedia, Wikidata, LinkedIn, or Crunchbase exist to establish entity identity.

---

🔧 Recommended Fixes

Ordered by estimated impact:

1. Add AI Discovery files — Create /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json on the docs site. This addresses the 0/100 ai_discovery score and is the highest-leverage structural change.
2. Add robots.txt with AI-bot Allow rules to the docs site — Include explicit Allow for GPTBot, ClaudeBot, and PerplexityBot. Currently 0/100.
3. Add llms.txt to the docs site — Run geo llms --base-url https://github.github.com/gh-aw to generate a structured content map for AI indexing. Currently 0/100.
4. Add JSON-LD schema to the README/repo homepage — Add WebSite, Organization (with sameAs links), and FAQPage structured data. This is the single largest gap (0/100) for the README.
5. Fix negative signals — The README has 9 broken links and keyword stuffing (github at 2.6% density). The docs site has display:none hidden content that AI crawlers may penalize.
6. Add <link rel="canonical"> to the docs site — Prevents duplicate-content penalties in AI indexing.
7. Front-load key information — Move the most important content about gh aw into the first 30% of both the README and docs site pages for better AI snippet selection.
8. Add VideoObject schema — Video content on the docs site has no structured metadata; add name, description, thumbnailUrl, and uploadDate.

📋 Full Score Breakdown by Category

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

Category	Score
Robots.txt	0/100
llms.txt	0/100
AI Discovery	0/100
Signals	6/100
Content	7/100
Brand & Entity	7/100
Schema JSON-LD	13/100
Meta Tags	14/100
Negative penalty	-3

Negative signals detected: keyword stuffing (github at 2.8%), hidden text (display:none/visibility:hidden).

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

Category	Score
Schema JSON-LD	0/100
AI Discovery	0/100
Signals	3/100
Brand & Entity	3/100
Meta Tags	11/100
Content	12/100
llms.txt	14/100
Robots.txt	15/100
Negative penalty	-3

Negative signals detected: 9 broken links, keyword stuffing (github at 2.6%), popup/modal signals.

📄 Sitemap Page Scores

Top pages from the sitemap audit (20 pages crawled):

URL	Score
github.github.com/gh-aw	44
.../blog/2026-01-13-meet-the-workflows-continuous-improvement	44
.../blog/2026-01-13-meet-the-workflows-continuous-refactoring	43
.../blog/2026-01-12-welcome-to-pelis-agent-factory	41
.../blog/2026-01-13-meet-the-workflows-advanced-analytics	41
.../blog/2026-01-13-meet-the-workflows-campaigns	41
.../blog/2026-01-13-meet-the-workflows-continuous-simplicity	41
.../blog/2026-01-13-meet-the-workflows-continuous-style	41
.../agent-factory-status	37
.../blog	36

All pages cluster in the Foundation band (36–44). Site-wide structural fixes (robots.txt, llms.txt, AI discovery files, JSON-LD schema) will lift all pages simultaneously.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · sonnet46 · 24.7 AIC · ⌖ 10.9 AIC · ⊞ 5K · ◷

• expires on Jul 29, 2026, 8:44 AM UTC-08:00