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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-28
Run: §30380289173

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	44/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Docs sitemap average (20 pages)	38.15/100	Foundation (16 pages) / Critical (4 pages)

---

✅ Top Strengths

• README meta tags: strong score (11/... ) with reasonable content signal (12) — README is the best-scoring surface.
• README robots/llms partial credit: robots=15, llms=14, showing some existing crawler-friendly setup on GitHub.com itself.
• Docs site meta tags: solid 14/points across nearly every sampled page — consistent metadata coverage.
• No broken links or thin content flagged on the docs site; negative signal severity is only "medium" with just 2 signals found.
• No failed URL fetches in the sitemap crawl — all 20 sampled pages returned HTTP 200.

---

🚨 Critical Gaps

1. robots.txt = 0/100 site-wide (docs site and all 20 sitemap pages) — no explicit Allow rules for AI bots (GPTBot, ClaudeBot, PerplexityBot).
2. llms.txt = 0/100 site-wide — no /llms.txt exists to help AI systems structure and index content.
3. ai_discovery = 0/100 everywhere (docs site, README, and all sitemap pages) — no /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json.
4. Hidden text / cloaking pattern detected on both the docs site and README (display:none/visibility:hidden with real content) — AI crawlers can read it and may penalize this.
5. Missing schema on README: no WebSite, Organization, or FAQPage JSON-LD; no sameAs links for Knowledge Graph disambiguation.
6. Keyword stuffing on the docs homepage ('github' at 2.8% density).
7. 4 sitemap pages are in the "Critical" band (blog/7, blog/8, blog/10, about — scores 33–35), largely due to low schema (3) and brand/entity (2) scores.

---

🔧 Recommended Fixes (prioritized by impact)

1. Create robots.txt with explicit Allow rules for GPTBot, ClaudeBot, PerplexityBot (fixes 0-point gap across every page — largest single lever).
2. Create /llms.txt at the docs site root (geo llms --base-url https://github.github.com/gh-aw) to structure content for AI indexing.
3. Remove hidden text / cloaking (display:none/visibility:hidden elements with real content) on docs site and README.
4. Add Organization + WebSite JSON-LD schema to the README/homepage, including sameAs links to relevant knowledge bases (e.g., GitHub org page, LinkedIn) for entity disambiguation.
5. Add AI-discovery surface files: /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json — currently 0/100 across all properties.
6. Front-load key information in the first 30% of docs pages for AI snippet selection, and add concrete numerical data/statistics (~+40% AI visibility per the audit heuristic).
7. Fix low-scoring "Critical" pages (about, blog/7, blog/8, blog/10) — improve schema and brand/entity signals specifically on these.
8. Diversify vocabulary on docs homepage to reduce keyword-stuffing penalty (~2.8% density for "github").

📋 Full Breakdown by Category

Docs site (github.github.com/gh-aw/) — Score 44 (Foundation)

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

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

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

README negative signals: severity medium, 9 broken links detected, popup signals present, author signal present, boilerplate ratio 0.18.

Docs sitemap average (20 pages, 205 discovered, 0 failed)

Category	Avg Score
Robots.txt	0.0
llms.txt	0.0
Schema JSON-LD	5.75
Meta Tags	14.0
Content	10.75
Signals	5.4
AI Discovery	0.0
Brand & Entity	3.2
Negative penalty	-0.95

Band distribution: 16 Foundation, 4 Critical, 0 Good/Excellent.

📄 Sitemap Page Scores

Top pages:

URL	Score	Band
/gh-aw (home)	44	Foundation
/blog/2026-01-13-meet-the-workflows-continuous-improvement	44	Foundation
/blog/2026-01-13-meet-the-workflows-continuous-refactoring	43	Foundation
/blog/2026-01-12-welcome-to-pelis-agent-factory	41	Foundation
/blog/2026-01-13-meet-the-workflows-advanced-analytics	41	Foundation

Worst pages:

URL	Score	Band
/blog/7	33	Critical
/blog/8	35	Critical
/blog/10	35	Critical
/about	35	Critical
/blog/9	36	Foundation

---

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

Generated by 🌍 GEO Optimizer Daily Audit · sonnet50 · 18 AIC · ⌖ 10.4 AIC · ⊞ 6.6K · ◷

• expires on Jul 31, 2026, 8:59 AM UTC-08:00