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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-08-05
Run: §31027445790

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	44/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Sitemap average (20 pages sampled)	37.75/100	Foundation (14 foundation, 6 critical)

---

✅ Top Strengths

• README's robots (15/15) and llms (14/15) sub-scores are strong — GitHub's platform-level robots/llms handling works in our favor.
• Meta tags are consistently well-formed across docs pages (14/~15 on nearly every sampled page).
• No broken links or thin content detected on the docs site; low boilerplate ratio (3%).
• No failed URL fetches — all 20 sampled sitemap pages returned HTTP 200.
• Docs site schema score (13) is meaningfully ahead of blog posts (3–8), showing the homepage already has some structured data.

---

🚨 Critical Gaps

1. ai_discovery and llms scores are 0 across every docs page — there is no /llms.txt, /.well-known/ai.txt, or /ai/*.json discovery surface on the docs site.
2. robots score is 0 on all docs pages — no explicit Allow rules for AI crawlers (GPTBot, ClaudeBot, PerplexityBot) on github.github.com/gh-aw.
3. Hidden text detected (display:none/visibility:hidden with content) on both the docs site and README — flagged as a potential cloaking penalty by AI crawlers.
4. README has zero JSON-LD schema (schema: 0/15) — no WebSite/Organization/FAQPage structured data.
5. Blog posts score in the "critical" band (33–35/100) — schema (3), brand_entity (2–4), and signals (5) are all weak, dragging down the sitemap average.
6. Keyword stuffing ('github' at 2.5% density) flagged on both docs site and README.

---

🔧 Recommended Fixes (prioritized by impact)

1. Create /llms.txt for the docs site (geo llms --base-url https://github.github.com/gh-aw) — unlocks the llms sub-score (currently 0 across all 20 sampled pages).
2. Add robots.txt with explicit Allow rules for AI bots (GPTBot, ClaudeBot, PerplexityBot) on the docs site — currently scoring 0/15 site-wide.
3. Add WebSite + Organization JSON-LD schema to the README/homepage, including sameAs links to GitHub org/Wikidata for entity disambiguation (schema is 0/15 on README).
4. Remove hidden text (display:none/visibility:hidden) on both docs site and README to avoid cloaking penalties.
5. Create /.well-known/ai.txt and /ai/summary.json, /ai/faq.json, /ai/service.json — flagged as missing on every audited surface; these are cheap, structural wins for AI discovery.
6. Improve schema/brand_entity on blog posts (currently 2–4/15) — add Article/BlogPosting JSON-LD with author, datePublished, and organization entity references to lift the 6 "critical" band posts.
7. Diversify keyword density ('github' repeated at 2.5%) to avoid stuffing penalties.
8. Front-load key facts/statistics in the first 30% of docs content — flagged as a content recommendation with an estimated "+40% AI visibility" for numerical/statistical data.

📋 Full Breakdown by Category

Docs site (score_breakdown): robots 0, llms 0, schema 13, meta 14, content 7, signals 6, ai_discovery 0, brand_entity 7, negative_penalty -3

README (score_breakdown): robots 15, llms 14, schema 0, meta 11, content 12, signals 3, ai_discovery 0, brand_entity 3, negative_penalty -3

Sitemap average (20 pages, 215 discovered — capped): robots 0.0, llms 0.0, schema 5.5, meta 14.0, content 10.75, signals 5.35, ai_discovery 0.0, brand_entity 3.1, negative_penalty -0.95

Negative signals:

• Docs site: severity medium, 2 signals (keyword stuffing), boilerplate ratio 3%
• README: severity medium, 3 signals (popup signals, keyword stuffing, author signal present), 9 broken links, boilerplate ratio 16%

📄 Sitemap Page Scores

Top pages:

URL	Score	Band
/gh-aw (homepage)	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 (--max-urls cap). A fuller crawl would give more representative coverage of the docs section vs. blog posts.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · auto · 18 AIC · ⌖ 4.1 AIC · ⊞ 7.2K · ◷

• expires on Aug 8, 2026, 9:03 AM UTC-08:00