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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-20
Run: §27877710153

---

📊 Scores

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

---

✅ Top Strengths

• Perfect meta tags on docs site (14/14) — title, description, OG tags, and canonical URL all present
• Schema JSON-LD on docs site (12/16) — WebSite, Organization, SoftwareApplication, and FAQPage types implemented
• Excellent robots.txt on README (15/18) — 27+ AI bots explicitly allowed, including GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and more
• Solid llms.txt on README (14/18) — 2,919 words, 12 sections, 117 links; structured for AI indexing
• Full signals on docs site (6/6) — language tag, RSS feed, and freshness date all present
• AI bots unblocked — GPTBot, ClaudeBot, and PerplexityBot all receive HTTP 200 on the docs site
• Content accessible without JavaScript — Astro-rendered full HTML, 918+ words in raw source

---

🚨 Critical Gaps

1. No robots.txt on docs site (0/18) — AI crawler permissions undefined for github.github.com/gh-aw/
2. No llms.txt on docs site (0/18) — no AI indexing guidance for the docs site
3. No AI discovery endpoints on either target (0/6 each) — /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json absent on both
4. No Schema JSON-LD on README (0/16) — entire schema layer missing from the GitHub project page
5. 19 of 20 sitemap pages score Critical (avg 31.65/100) — homepage is the only Foundation-band page

---

🔧 Recommended Fixes

Ordered by impact:

1. Add robots.txt to docs site (up to +18 pts) — explicitly allow GPTBot, ClaudeBot, PerplexityBot and other AI crawlers
2. Add llms.txt to docs site (up to +18 pts, propagates sitewide) — run geo llms --base-url https://github.github.com/gh-aw; lifts all 19 critical-band pages
3. Create AI discovery endpoints on docs site (+6 pts) — add /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json
4. Add llms.full.txt (+pts on README) — existing llms.txt has has_full: false; adding the companion file completes the standard
5. Fix 12 broken links on README (removes negative signal)
6. Add About page to docs site — has_about_link: false suppresses brand entity trust
7. Add Wikipedia/Crunchbase sameAs entries — currently 2/4 KG pillars (LinkedIn + Wikidata only)
8. Diversify keyword density — github at 2.8% on docs site, issue at 22.5% on README both flagged as keyword stuffing

📋 Full Breakdown by Category

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

Category	Score	Max	Status
Robots.txt	0	18	❌ Missing
llms.txt	0	18	❌ Missing
Schema JSON-LD	12	16	✅ Partial (WebSite, Org, SoftwareApp, FAQPage)
Meta Tags	14	14	✅ Perfect
Content	7	12	✅ Pass
Signals	6	6	✅ Perfect (lang, RSS, freshness)
AI Discovery	0	6	❌ Missing
Brand & Entity	6	10	⚠️ Partial
Negative Penalty	-3	—	⚠️ Keyword stuffing, hidden text

Negative signals: keyword stuffing (github 2.8%), hidden text detected (possible cloaking penalty).
Trust stack: Technical 3/5, Identity 3/5, Social 4/5, Academic 1/5, Consistency 4/5.
WebMCP: basic readiness — SearchAction present but no tool attributes; not agent-ready.

---

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

Category	Score	Max	Status
Robots.txt	15	18	✅ Strong (27+ AI bots allowed)
llms.txt	14	18	✅ Good (2,919 words, 12 sections, 117 links)
Schema JSON-LD	0	16	❌ Missing
Meta Tags	11	14	⚠️ No canonical URL
Content	12	12	✅ Perfect
Signals	3	6	⚠️ No RSS, no freshness date
AI Discovery	0	6	❌ Missing
Brand & Entity	3	10	⚠️ Weak (0/4 KG pillars)
Negative Penalty	-3	—	⚠️ Keyword stuffing, popup, 12 broken links

Negative signals: issue at 22.5% density, popup signals, 12 broken links.
Trust stack: Technical 5/5 (full — HTTPS, HSTS, CSP, X-Frame-Options).
WebMCP: basic — 3 labeled forms but no tool attributes; no OpenAPI spec.

📄 Sitemap Page Scores (20 of 189 pages audited)

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
33	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-improvement
32	Critical	https://github.github.com/gh-aw/blog/2
32	Critical	https://github.github.com/gh-aw/blog/6
32	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-refactoring
30	Critical	https://github.github.com/gh-aw/blog/7
30	Critical	https://github.github.com/gh-aw/blog/9
30	Critical	https://github.github.com/gh-aw/blog/2026-01-12-welcome-to-pelis-agent-factory
30	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-advanced-analytics
30	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-campaigns
30	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-simplicity
30	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-style
30	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-creative-culture
30	Critical	https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-documentation
27	Critical	https://github.github.com/gh-aw/agent-factory-status

189 URLs discovered in sitemap; 20 audited. Band breakdown: 1 Foundation, 19 Critical.

Fixing robots.txt and llms.txt at the docs site root will propagate improvements across all 189 pages.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 37.6 AIC · ⌖ 10.2 AIC · ⊞ 4.5K · ◷

• expires on Jun 23, 2026, 8:59 AM UTC-08:00

[github-actions[bot]]

This discussion has been marked as outdated by GEO Optimizer Daily Audit.

A newer discussion is available at Discussion #40657.