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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-08-02
Run: §30757076353

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	44/100	Foundation
Docs sitemap avg (20 pages sampled of 213)	38.15/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation

Neither surface reaches "Good" (70+) or "Excellent" (90+) yet — both sit in the Foundation band, meaning core plumbing exists but key AI-discovery signals are missing.

---

✅ Top Strengths

• README has strong robots.txt (15/18) allowing 27 AI bots (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.) and a solid /llms.txt (14/18, 2919 words, 12 sections, 117 links).
• Docs site has complete meta tags (14/14: title, description, canonical, OG tags) and strong schema (13/16: WebSite, Organization, SoftwareApplication, FAQPage all present).
• Trust stack on docs site is medium (Grade C, composite 16): HTTPS+HSTS, consistent brand name, 4/4 knowledge-graph pillars (Wikipedia, Wikidata, LinkedIn, Crunchbase).
• Platform citation estimates for docs site are already decent: Google AI 80/100, Perplexity 65/100, ChatGPT 50/100 — driven by schema, freshness, and RSS feed presence.
• No JS-rendering dependency (content available in raw HTML — "1101 words in raw HTML, no JS required").

---

🚨 Critical Gaps

1. robots.txt missing on docs site (0/18) — despite the README having a great one, github.github.com/gh-aw/ has no robots.txt allowing AI bots explicitly.
2. /llms.txt missing on docs site (0/18) — the README has one but the docs site does not.
3. AI Discovery signals absent everywhere (0/6 on both surfaces) — no /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json.
4. README has no schema JSON-LD (0/16) — no WebSite/Organization/FAQPage schema on the GitHub repo homepage, unlike the docs site.
5. Hidden text / prompt-injection flag on docs site — "CtrlK" search hint detected as display:none content, triggering a −3 negative penalty (cloaking risk).
6. Worst sitemap pages (score 33–35, "critical" band): /blog/7, /blog/8, /blog/10, /about — mostly weak schema (3/16) and brand/entity signals (2/10).

---

🔧 Recommended Fixes

1. Highest impact: Create robots.txt for github.github.com/gh-aw/ with explicit Allow rules for GPTBot, ClaudeBot, PerplexityBot, Google-Extended (mirrors the README's existing policy) — worth up to 18 points.
2. Generate /llms.txt for the docs site (geo llms --base-url https://github.github.com/gh-aw) — up to 18 points.
3. Add Organization + WebSite JSON-LD schema (with sameAs links to Wikipedia/Wikidata/LinkedIn/Crunchbase) to the README/repo homepage — up to 16 points.
4. Add /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json across both surfaces — up to 6 points each, currently 0/6 everywhere.
5. Remove or properly aria-hide the "CtrlK" hidden search-hint text to eliminate the cloaking penalty (−3).
6. Front-load key info in the first 30% of docs-site content (currently front-loaded ratio only 0.33) and add concrete numbers/statistics (+40% AI visibility potential per the audit).
7. Improve the lowest-scoring blog/about pages (schema 3/16, brand_entity 2/10) by adding consistent Organization schema and FAQ blocks.

📋 Full Breakdown by Category

Docs site (score_breakdown):

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	6
AI Discovery	0	6
Brand & Entity	7	10
Negative penalty	−3	—

README (score_breakdown):

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	6
AI Discovery	0	6
Brand & Entity	3	10
Negative penalty	−3	—

Sitemap average across 20 pages (of 213 discovered): 38.15/100 — robots 0.0, llms 0.0, schema 5.75/16, meta 14.0/14, content 10.75/12, signals 5.4/6, ai_discovery 0.0/6, brand_entity 3.2/10.

Platform citation estimates (docs site): ChatGPT 50/100, Perplexity 65/100, Google AI 80/100.

📄 Sitemap Page Scores

20 of 213 discovered pages audited (batch mode). Band distribution: 16 Foundation, 4 Critical, 0 Good/Excellent.

Top scoring pages:

• github.github.com/gh-aw — 44 (Foundation)
• .../blog/2026-01-13-meet-the-workflows-continuous-improvement — 44 (Foundation)
• .../blog/2026-01-13-meet-the-workflows-continuous-refactoring — 43 (Foundation)

Worst scoring pages (Critical band):

• .../blog/7 — 33
• .../blog/8 — 35
• .../blog/10 — 35
• .../about — 35

All sampled pages share the same systemic gaps: 0/18 robots, 0/18 llms.txt, 0/6 AI discovery.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · auto · 25.7 AIC · ⌖ 4.89 AIC · ⊞ 7.2K · ◷

• expires on Aug 5, 2026, 8:44 AM UTC-08:00