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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-08-01
Run: §30708587097

---

📊 Scores

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

---

✅ Top Strengths

• Meta tags: perfect 14/14 on both docs homepage and README — title, description, canonical, and full Open Graph set are present.
• Schema JSON-LD (docs site): 13/16 — WebSite, Organization, SoftwareApplication, and FAQPage types all detected.
• Signals (docs site): perfect 6/6 — lang="en", RSS feed (/blog/rss.xml), and freshness date (2026-05-09) all present.
• Brand & entity (docs site): 7/10 — consistent brand naming plus 4/4 Knowledge Graph pillar links (Wikipedia, Wikidata, LinkedIn, Crunchbase).
• README robots/llms: unlike the docs site, the README already scores 15/robots and 14/llms — GitHub's own repo infrastructure gives it partial credit here.
• Platform citability: strong per-engine potential — ChatGPT 50/100, Perplexity 65/100, Google AI 80/100 — driven by FAQ schema, content freshness, and SSR-safe (non-JS-dependent) rendering.

---

🚨 Critical Gaps

1. robots.txt missing AI bot rules — 0/18 on the docs site (and every one of the 20 sitemap pages scores 0 here too). No Allow rules for GPTBot, ClaudeBot, or PerplexityBot were found.
2. /llms.txt missing — 0/18 across the entire docs site and sitemap (all 20 pages average 0.0 on this dimension) — no LLM-oriented site summary exists.
3. AI discovery endpoints missing — 0/6: no /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json on either target.
4. Schema JSON-LD missing on README — 0/16: no WebSite, Organization, or FAQPage structured data on the GitHub repo homepage.
5. Hidden text / cloaking detected on the docs homepage (display:none/visibility:hidden content, e.g. "CtrlK") — flagged as a medium-severity negative signal that AI crawlers may penalize.
6. 4 sitemap pages fall into the "Critical" band (/about 35, /blog/7 33, /blog/8 35, /blog/10 35) — mostly driven by weaker schema (3/16) and brand/entity scores (2–4/10) on paginated blog listing pages.

---

🔧 Recommended Fixes (prioritized by impact)

1. Create robots.txt with explicit Allow rules for AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended) on the docs site — this single change would recover up to 18 points on every one of the 20 audited pages.
2. Generate /llms.txt via geo llms --base-url https://github.github.com/gh-aw — recovers up to 18 points site-wide and gives AI engines a structured index of the site.
3. Add WebSite/Organization/FAQPage JSON-LD schema to the README — closes the 16-point schema gap that exists only on the GitHub repo page (the docs site already has this).
4. Remove/fix hidden text (display:none/visibility:hidden) on the docs homepage to eliminate the -3 negative-signal penalty and cloaking risk.
5. Add /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json to define AI crawler permissions and machine-readable site/service summaries (+6 points, "ai_discovery" category currently at 0 on both targets).
6. Front-load key information in the first 30% of page content for AI snippet selection (docs homepage has_front_loading: false), and add numerical/statistics data (+40% AI visibility per the tool's own estimate).
7. Improve schema on paginated blog pages (/blog/2–/blog/10) — these average only 5.75/16 on schema vs. 13/16 on the homepage, dragging the sitemap-wide average down to 38.15.

📋 Full Breakdown by Category (docs homepage vs. README)

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

Sitemap-wide average breakdown (20 pages): robots 0.0, llms 0.0, schema 5.75, meta 14.0, content 10.75, signals 5.4, ai_discovery 0.0, brand_entity 3.2, negative_penalty -0.95.

Trust Stack (docs homepage): composite score 16, grade C, medium trust level — Technical 3/5, Identity 3/5, Social 4/5, Academic 2/5, Consistency 4/5.

Platform citation scores: ChatGPT 50/100, Perplexity 65/100, Google AI 80/100 (citability score 78/100 underlying all three).

📄 Sitemap Page Scores (20 pages audited)

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

Top 5 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 5 pages:

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

All 20 URLs returned HTTP 200 with no failed crawls.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · auto · 26.9 AIC · ⌖ 13.9 AIC · ⊞ 7.1K · ◷

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