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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-07
Run: §28884265311

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	43/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Sitemap avg (20 pages sampled)	36.45/100	Foundation/Critical

---

✅ Top Strengths

• README robots.txt — 27 AI bots explicitly allowed, including GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and more (score: 15/18)
• README llms.txt — Present and well-structured: 2,919 words, 12 sections, 117 links, blockquote present (score: 14/18)
• Docs site meta tags — Full score: title, description, canonical, all Open Graph tags present (14/14)
• Docs site schema — WebSite, Organization, SoftwareApplication, and FAQPage JSON-LD all detected (12/16)
• Docs site signals — Language tag, RSS feed, and freshness date all present (6/6); content renders without JavaScript (Astro framework, SSR-safe)

---

🚨 Critical Gaps

1. No robots.txt on docs site — github.github.com/gh-aw/ returns no robots.txt, scoring 0/18. AI bots have no explicit permission signal and may deprioritize the docs site.
2. No llms.txt on docs site — The docs site lacks /llms.txt, scoring 0/18 and missing a structured summary that LLMs use for site-level understanding.
3. No AI discovery endpoints anywhere — Both docs site and README score 0/6 on AI Discovery. No /.well-known/ai.txt, no /ai/summary.json, /ai/faq.json, or /ai/service.json exist.
4. README missing JSON-LD schema — GitHub repo page has zero schema markup (0/16), leaving Google AI, ChatGPT, and others without structured entity signals.
5. Weak brand/entity signals on README — Brand entity score is only 3/10: no sameAs KG pillar links (Wikipedia, Wikidata, LinkedIn, Crunchbase) present in schema; missing canonical URL.

---

🔧 Recommended Fixes

Ordered by estimated impact:

1. 🥇 Add /llms.txt to the docs site (github.github.com/gh-aw/llms.txt) — Closes the largest single gap (+18 pts potential). Run geo llms --base-url https://github.github.com/gh-aw to generate. Also add a companion llms-full.txt.
2. 🥈 Add robots.txt to the docs site with explicit Allow rules for GPTBot, ClaudeBot, PerplexityBot, Google-Extended — worth up to +18 pts on docs site score.
3. 🥉 Add AI Discovery endpoints to the docs site — Create /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json (+6 pts, enables structured AI service discovery).
4. Add JSON-LD schema to the README — WebSite + Organization + FAQPage schema on the GitHub repo page would recover the full 16 pts currently missing there.
5. Add sameAs KG pillar links to Organization schema on both surfaces — Link to Wikipedia, Wikidata, LinkedIn, Crunchbase for Knowledge Graph disambiguation.
6. Front-load key information on the docs site home — Current front_loaded_ratio is 0.38; target >0.5 so AI engines extract the value proposition early.
7. Add VideoObject schema — Docs site has 2 videos without VideoObject schema; add name, description, thumbnailUrl, uploadDate to make videos citable.
8. Resolve hidden-text penalty — Both surfaces detected hidden text (display:none elements) generating a -3 negative penalty. The docs site has a CtrlK keyboard-shortcut label; ensure decorative UI strings are excluded from the DOM or properly aria-hidden.

---

📋 Full Breakdown by Category

Docs Site (github.github.com/gh-aw/) — 43/100 Foundation

Category	Score	Max	Notes
robots.txt	0	18	File not found
llms.txt	0	18	File not found
Schema JSON-LD	12	16	WebSite, Organization, SoftwareApplication, FAQPage present; WebApp missing
Meta Tags	14	14	✅ Full score
Content	7	12	No numerical data, no lists/tables, no front-loading; 921 words
Signals	6	6	✅ Full score — lang, RSS, freshness date
AI Discovery	0	6	No well-known/ai.txt, no summary/faq/service endpoints
Brand & Entity	7	10	No about page link, no author attribution, schema desc ≠ meta desc
Negative Penalty	-3	—	Hidden text detected, keyword stuffing (github at 2.8%)

Trust Grade: C (medium) · WebMCP Readiness: Basic (not agent-ready) · RAG Chunk Score: 45/100 · Citability: 79/100

Platform Citation Scores: Google AI 80/100 · Perplexity 65/100 · ChatGPT 50/100

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

Category	Score	Max	Notes
robots.txt	15	18	27 bots allowed; citation_bots_explicit: false
llms.txt	14	18	Present — 2,919 words, 12 sections, 117 links; llms-full.txt missing
Schema JSON-LD	0	16	No schema whatsoever on GitHub.com repo page
Meta Tags	11	14	Missing canonical URL; description is generic GitHub boilerplate (98 chars)
Content	12	12	✅ Full score — 1,498 words, numbers, lists/tables, front-loaded
Signals	3	6	Language tag present; no RSS feed; no freshness date
AI Discovery	0	6	Same as docs site — no AI-specific endpoints
Brand & Entity	3	10	No KG pillar sameAs links in schema; no contact info; no social schema
Negative Penalty	-3	—	Hidden text, keyword stuffing (github 2.6%), popup signals, 13 broken links

Trust Grade: C (medium) · Decay Risk: High (version numbers and dates detected; evergreen score 70/100) · Citability: 86/100

Platform Citation Scores: Perplexity 70/100 · ChatGPT 55/100 · Google AI 48/100

📄 Sitemap Page Scores (20 of 196 pages sampled)

Average score: 36.45/100 — 9 Foundation, 11 Critical

Shared zero-score categories across all sampled pages: robots.txt (0/18), llms.txt (0/18), AI Discovery (0/6)

Top 5 Pages

URL	Score	Band
/blog/2026-01-13-meet-the-workflows-continuous-improvement	44	Foundation
/ (homepage)	43	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 2 Pages

URL	Score	Band
/blog/10	30	Critical
/blog/8	31	Critical

Note: Pagination/index pages score critically low; blog content pages score higher thanks to Article schema.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 26.8 AIC · ⌖ 19.8 AIC · ⊞ 4.9K · ◷

• expires on Jul 10, 2026, 9:13 AM UTC-08:00

[github-actions[bot]]

This discussion has been marked as outdated by GEO Optimizer Daily Audit.

A newer discussion is available at Discussion #44597.