[geo-optimizer] GEO Audit Report — 2026-08-09

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-08-09
Run: https://github.com/github/gh-aw/actions/runs/31324049076

---

📊 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)	37.75/100	Foundation

---

✅ Top Strengths

• README meta tags (11/20) and robots (15/25) are relatively solid vs. docs site.
• Docs site has partial JSON-LD schema (13 pts) and decent meta tags (14 pts).
• No broken links or thin content detected on the docs site; low boilerplate ratio (3%).
• No HTTP failures across any of the 20 sitemap pages audited (100% success rate).

---

🚨 Critical Gaps

• robots.txt and llms.txt are both scoring 0/points on the docs site — no AI-crawler allowlisting or /llms.txt indexing signal exists.
• schema is 0/points on the README — no JSON-LD (WebSite/Organization/FAQPage) at all.
• ai_discovery is 0/points on both targets — missing /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json.
• Hidden text (cloaking pattern) detected on both docs site and README — display:none/visibility:hidden content that AI crawlers can read and may penalize.
• Keyword stuffing: "github" at 2.5–2.7% density on both targets, hurting content-quality signals.
• README negative signals: 9 broken links detected, plus popup signals — both degrading trust.
• Weakest sitemap pages are numbered blog posts (/blog/11, /blog/9, /blog/8, /blog/7, /blog/4) all scoring in the Critical band (33–35/100), dragging the average down.

---

🔧 Recommended Fixes

1. Create /llms.txt for the docs site (geo llms --base-url https://github.github.com/gh-aw) — highest-leverage, zero-conflict fix for the biggest 0-point category.
2. Create robots.txt with explicit Allow rules for AI bots (GPTBot, ClaudeBot, PerplexityBot) on the docs site.
3. Add JSON-LD schema to the README/homepage: WebSite, Organization (with sameAs links to Wikipedia/Wikidata/LinkedIn), and FAQPage.
4. Fix hidden/cloaked text on both docs site and README — remove or make visible any display:none/visibility:hidden content with real copy.
5. Add /.well-known/ai.txt and the /ai/summary.json, /ai/faq.json, /ai/service.json triad for structured AI discovery on both targets.
6. Fix the 9 broken links on the README.
7. Reduce keyword density ("github" repeated) by diversifying vocabulary across README and docs.
8. Improve the 5 lowest-scoring blog posts (/blog/4, /blog/7, /blog/8, /blog/9, /blog/11) — all in the Critical band; add schema, front-load key info, and add concrete stats/numbers (+40% AI visibility per audit).

📋 Full Breakdown by Category

Docs site (score_breakdown):

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 (score_breakdown):

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

Docs site negative signals: severity=medium, 2 signals found, keyword stuffing=true, boilerplate ratio=0.03.

README negative signals: severity=medium, 3 signals found, keyword stuffing=true, popup signals=true, author signal=true, broken links=9, boilerplate ratio=0.16.

📄 Sitemap Page Scores

Averages: 20/20 URLs audited successfully, average score 37.75/100 (Foundation band).

Top pages:

URL	Score
/gh-aw (homepage)	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

Worst pages (Critical band):

URL	Score
/blog/11	33
/blog/9	34
/blog/8	35
/blog/7	35
/blog/4	35

---

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

Generated by 🌍 GEO Optimizer Daily Audit · auto · 17.8 AIC · ⌖ 3.87 AIC · ⊞ 7K · ◷

• expires on Aug 12, 2026, 8:37 AM UTC-08:00