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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-27
Run: §30287372882

---

📊 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)	38/100	Foundation

---

✅ Top Strengths

• Meta tags score well across all pages (14/15 avg) — page titles and descriptions are properly set
• README has robots.txt + llms.txt signals (15 + 14 pts) — AI bots are not blocked and an llms.txt-style signal exists on the GitHub repo itself
• Author signal present in README — helps establish content provenance for AI engines
• No thin content detected across audited pages
• Content scores on blog posts are relatively strong (10–12/15) showing well-structured articles

---

🚨 Critical Gaps

1. robots.txt = 0/15 on docs site — No robots.txt with explicit Allow rules for AI bots (GPTBot, ClaudeBot, PerplexityBot). Every single docs page scores zero here.
2. llms.txt = 0/15 on docs site — No /llms.txt file exists at github.github.com/gh-aw/. This structured index is the primary discovery mechanism for AI engines scanning documentation sites.
3. AI Discovery = 0/10 everywhere — No /.well-known/ai.txt, no /ai/summary.json, /ai/faq.json, or /ai/service.json exist on the docs site.
4. Schema JSON-LD = 0–13/15 — README has no WebSite/Organization schema; docs site pages have partial or no structured data. Pagination pages (/blog/7, /blog/8, etc.) score 3/15.
5. 9 broken links in README and hidden text on docs site trigger negative penalties (-3 pts) across multiple pages.
6. Brand & Entity signals weak (2–7/15) — No sameAs links to Wikidata/Wikipedia, no Organization schema with contact info.

---

🔧 Recommended Fixes (by impact)

Priority	Fix	Est. Score Gain
🔴 1	Create /llms.txt on docs site (gh aw geo llms --base-url https://github.github.com/gh-aw)	+14 pts
🔴 2	Add robots.txt with Allow directives for GPTBot, ClaudeBot, PerplexityBot	+15 pts
🟠 3	Create /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json	+10 pts
🟠 4	Add WebSite + Organization JSON-LD schema to README/homepage with sameAs links	+10 pts
🟡 5	Fix 9 broken links in README to eliminate negative penalty	+3 pts
🟡 6	Add numerical statistics and concrete data points to README content	+5 pts
🟡 7	Add VideoObject schema for any embedded videos	+2–5 pts
🟢 8	Add FAQPage JSON-LD schema to docs pages	+5 pts

📋 Full Breakdown by Category

Docs Site (github.github.com/gh-aw/) — Score: 44/100

Category	Score	Max	Notes
robots.txt	0	15	Missing entirely
llms.txt	0	15	Missing entirely
Schema JSON-LD	13	15	Partial structured data
Meta Tags	14	15	Good
Content	7	15	Keyword stuffing (github at 2.8%), hidden text detected
Signals	6	10	No author signal
AI Discovery	0	10	No ai.txt or AI JSON files
Brand & Entity	7	10	Partial
Negative Penalty	-3	—	Hidden text + keyword stuffing

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

Category	Score	Max	Notes
robots.txt	15	15	✅ GitHub platform allows AI bots
llms.txt	14	15	✅ GitHub provides llms signal
Schema JSON-LD	0	15	No WebSite/Organization/FAQPage schema
Meta Tags	11	15	Missing canonical link
Content	12	15	Good structure
Signals	3	10	Popup signals, low trust signals
AI Discovery	0	10	No ai.txt or AI JSON files
Brand & Entity	3	10	No sameAs, no org schema
Negative Penalty	-3	—	9 broken links, popup signals

Negative Signals Detail

• Docs site: keyword stuffing (github 2.8%), hidden text (display:none content) — severity: medium
• README: 9 broken links, popup signals detected — severity: medium

📄 Sitemap Page Scores (20 pages audited)

Average score: 38.15/100 | Average band: Foundation

🏆 Top Pages

URL	Score	Band
/ (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

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

Note: Pagination pages (/blog/N) consistently score lowest due to thin schema and low brand/entity signals. The /about page is in Critical band despite being a key trust page.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · sonnet46 · 20.4 AIC · ⌖ 10.6 AIC · ⊞ 5K · ◷

• expires on Jul 30, 2026, 9:09 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 #48694.