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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-08-08
Run: §31267168943

---

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

Sitemap band spread: 14 pages "foundation", 6 pages "critical" — no pages reached "Good" or "Excellent".

---

✅ Top Strengths

• README robots.txt: 15/18 — explicitly allows GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and 20+ other AI crawlers.
• README llms.txt: 14/18 — found, well-structured (H1, description, 12 sections, 117 links, 2919 words).
• Docs site meta tags: 14/14 (perfect) — title, description, canonical, and full OG tag set present.
• Docs site schema: 13/16 — WebSite, Organization, SoftwareApplication, and FAQPage JSON-LD types detected.
• README meta tags: 11/14 — title/description/OG tags present (missing only canonical link).

---

🚨 Critical Gaps

• Docs site has no robots.txt (0/18) — AI crawlers (GPTBot, ClaudeBot, PerplexityBot) have no explicit allow signal on github.github.com/gh-aw/, unlike the README which scores 15/18 here.
• Docs site has no llms.txt (0/18) — no AI-indexing companion file exists for the docs site, despite the README having a strong one (14/18).
• README has zero schema JSON-LD (0/16) — no WebSite, Organization, or FAQPage structured data on the GitHub repo homepage.
• AI Discovery score is 0/100 on both targets — neither has /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json.
• Negative signals on both: hidden text (display:none with content) flagged as a cloaking risk, plus keyword stuffing ("github" at 2.5–2.7% density). README also has 9 broken links and popup signals.
• Sitemap-wide: 6 of 20 sampled pages (mostly blog posts, e.g. /blog/11, /blog/9, /blog/8) fall into the "critical" band (33–35/100), driven by very low schema (3/16) and brand/entity scores.

---

🔧 Recommended Fixes (prioritized by impact)

1. Create robots.txt for the docs site (github.github.com/gh-aw/) with explicit Allow rules for GPTBot, ClaudeBot, PerplexityBot, and other AI crawlers — mirrors the README's approach and would apply site-wide across all 215 discovered pages (currently 0/18 → potential +18).
2. Create /llms.txt for the docs site: geo llms --base-url https://github.github.com/gh-aw — currently 0/18, would bring it in line with the README's 14/18.
3. Add Organization + WebSite JSON-LD schema to the README/repo homepage — currently 0/16; include sameAs links (Wikipedia/Wikidata/LinkedIn) for Knowledge Graph disambiguation.
4. Remove hidden text (display:none/visibility:hidden with content) on both the docs site and README — flagged as a cloaking pattern that AI crawlers may penalize.
5. Fix keyword stuffing ("github" density 2.5–2.7%) — diversify vocabulary across pages.
6. Fix the 9 broken links on the README page.
7. Add AI-discovery files (/.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json) to both targets — currently 0/100 on AI Discovery for both.
8. Improve schema on blog posts — the 6 "critical" band pages (/blog/11, /blog/9, /blog/8, /blog/7, /blog/4) all score only 3/16 on schema; adding Article/BlogPosting JSON-LD would lift them out of the critical band.

📋 Full Breakdown by Category

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

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

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

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

📄 Sitemap Page Scores (20 of 215 discovered URLs audited)

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 (critical band):

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

Note: sitemap contains 215 URLs but only 20 were audited (cap: --max-urls). Increase the cap for full-site coverage.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · auto · 20.4 AIC · ⌖ 3.35 AIC · ⊞ 7.2K · ◷

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

[github-actions[bot]]

This discussion was automatically closed because it expired on 2026-08-11T16:37:19.906Z.

Closed by Workflow