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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-06
Run: §28809885240

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	43/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Sitemap average (20 pages)	36/100	Foundation/Critical mix

---

✅ Top Strengths

1. Meta tags (docs site) — Full 14/14: title, description, canonical, OG title/description/image all present.
2. Signals (docs site) — Full 6/6: lang="en", RSS feed, and freshness date are all set.
3. Schema JSON-LD (docs site) — 12/16: WebSite, Organization, SoftwareApplication, and FAQPage types detected.
4. Brand & entity (docs site) — 7/10: consistent brand name, KG pillars (Wikipedia, Wikidata, LinkedIn, Crunchbase), contact info.
5. README robots.txt — 15/18: 27 AI bots explicitly allowed including GPTBot, ClaudeBot, PerplexityBot.
6. README llms.txt — 14/18: 2,919 words, 12 sections, 117 links, blockquote present.

---

🚨 Critical Gaps

1. No robots.txt on docs site (0/18) — AI crawlers have no explicit permission to index github.github.com/gh-aw/.
2. No llms.txt on docs site (0/18) — No structured content map for AI engines.
3. No AI discovery endpoints on either target (0/6 each) — /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json all absent.
4. Schema JSON-LD missing on README (0/16) — GitHub.com renders no structured data for repositories (platform limitation).
5. Sitemap pages mostly Critical — 11 of 20 pages in Critical band (≤35/100), sitewide average 36/100.
6. README meta description is generic — auto-generated GitHub text does not describe the tool value proposition.
7. Hidden text / keyword stuffing detected on both targets (~2.7% "github" density).

---

🔧 Recommended Fixes

Priority	Fix	Est. Impact
🔴 1	Add robots.txt to docs site with Allow rules for all major AI bots	+18 pts
🔴 2	Add /llms.txt to docs site (gh aw geo llms --base-url https://github.github.com/gh-aw)	+18 pts
🟠 3	Create /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json	+6 pts
🟠 4	Add llms-full.txt companion file (currently has_full: false)	+4 pts
🟡 5	Front-load key information in first 30% of homepage content	+5 pts
🟡 6	Add numbers/statistics to docs site homepage (has_numbers: false)	+2 pts
🟡 7	Add lists or tables to docs site homepage (has_lists_or_tables: false)	+2 pts
🟡 8	Ensure schema description matches meta description	+1 pt

📋 Full Breakdown by Category

Docs site (github.github.com/gh-aw/) — 43/100

Category	Score	Max	Status
robots_txt	0	18	❌ Missing
llms_txt	0	18	❌ Missing
schema_jsonld	12	16	✅ Partial (WebSite, Org, SoftwareApp, FAQPage)
meta_tags	14	14	✅ Full
content	7	12	⚠️ No numbers, no lists/tables, no front-loading
signals	6	6	✅ Full
ai_discovery	0	6	❌ All endpoints missing
brand_entity	7	10	⚠️ No about link, schema≠meta desc

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

Category	Score	Max	Status
robots_txt	15	18	✅ 27 AI bots allowed
llms_txt	14	18	✅ Present, no llms-full.txt
schema_jsonld	0	16	❌ None (GitHub platform limitation)
meta_tags	11	14	⚠️ No canonical, generic description
content	12	12	✅ Full
signals	3	6	⚠️ No RSS, no freshness date
ai_discovery	0	6	❌ All endpoints missing
brand_entity	3	10	⚠️ No KG pillars, no contact info

📄 Sitemap Page Scores (20 pages audited)

URL	Score	Band
.../blog/...-continuous-improvement	44	Foundation
.../ (homepage)	43	Foundation
.../blog/...-continuous-refactoring	43	Foundation
.../blog/...-advanced-analytics	41	Foundation
.../blog/...-campaigns	41	Foundation
.../blog/...-continuous-simplicity	41	Foundation
.../blog/...-continuous-style	41	Foundation
.../agent-factory-status	37	Foundation
.../about	35	Critical
.../blog	33	Critical
.../blog/2 through /blog/10	30–33	Critical

Average across 20 pages: 36.45/100 (9 Foundation, 11 Critical)

Blog pagination pages (/blog/2 through /blog/10) score in the Critical band, dragging down the sitewide average. Adding robots.txt and llms.txt at the root will lift all pages simultaneously.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 38.1 AIC · ⌖ 10 AIC · ⊞ 5K · ◷

• expires on Jul 9, 2026, 9:27 AM UTC-08:00