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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-12
Run: §29200475574

---

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

---

✅ Top Strengths

• README robots.txt — 27 AI bots explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, etc.), scoring 15/18
• README llms.txt — Present with 12 sections, 117 links, 2919 words, scoring 14/18
• Docs site Schema JSON-LD — WebSite, Organization, SoftwareApplication, FAQPage types all present, scoring 13/16
• Docs site meta tags — Full set: title, description, canonical, OG tags all present, scoring 14/14
• Docs site signals — RSS feed, language tag, and freshness date all present, scoring 6/6

---

🚨 Critical Gaps

1. No robots.txt on docs site (github.github.com/gh-aw/) — scores 0/18. AI crawlers have no explicit permission signal.
2. No llms.txt on docs site — scores 0/18. This is the highest-weight missing item on the docs site.
3. No AI Discovery endpoints (both targets) — /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json all missing, scoring 0/6 on both.
4. No Schema JSON-LD on README — scores 0/16; no WebSite, Organization, or FAQPage structured data.
5. Hidden text / keyword stuffing penalties — Both targets incur a −3 penalty: hidden content (display:none) and github keyword density ~2.7–2.8%.

---

🔧 Recommended Fixes (by impact)

1. Add llms.txt to docs site — Run geo llms --base-url https://github.github.com/gh-aw and deploy the file. Potential gain: up to +18 points on docs site score.
2. Add robots.txt to docs site with explicit Allow rules for AI bots (GPTBot, ClaudeBot, PerplexityBot, etc.). Potential gain: up to +18 points.
3. Create AI Discovery endpoints on docs site: /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json. Potential gain: +6 points.
4. Add Schema JSON-LD to README/GitHub page — WebSite + Organization + FAQPage schemas. Potential gain: up to +16 points.
5. Add llms.txt full companion file — Neither target has /llms-full.txt. Completing this would push the README llms score from 14→18.
6. Fix hidden text cloaking pattern on both sites to eliminate the −3 penalty each.
7. Add numerical statistics to docs site content to improve AI snippet selection (+40% estimated AI visibility per audit note).
8. Add Knowledge Graph pillars to README — Link to LinkedIn, Wikipedia, Wikidata, Crunchbase in Organization schema.

---

📋 Full Breakdown by Category

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

Category	Score	Max	Status
robots.txt	0	18	❌ Missing
llms.txt	0	18	❌ Missing
Schema JSON-LD	13	16	✅ WebSite, Org, SoftwareApp, FAQ
Meta Tags	14	14	✅ Full set
Content	7	12	⚠️ No numbers, no lists/tables, no front-loading
Signals	6	6	✅ RSS, language, freshness
AI Discovery	0	6	❌ No well-known/ai.txt or AI endpoints
Brand & Entity	7	10	⚠️ No about link, no geo schema, no hreflang
Negative Penalty	−3	—	Hidden text + keyword stuffing

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

Category	Score	Max	Status
robots.txt	15	18	✅ 27 AI bots allowed
llms.txt	14	18	✅ Present, no full companion file
Schema JSON-LD	0	16	❌ None
Meta Tags	11	14	⚠️ No canonical URL
Content	12	12	✅ Full score
Signals	3	6	⚠️ No RSS, no freshness date
AI Discovery	0	6	❌ No well-known/ai.txt or AI endpoints
Brand & Entity	3	10	⚠️ No KG pillars, no contact info
Negative Penalty	−3	—	Hidden text + keyword stuffing

📄 Sitemap Page Scores (top 20 pages, avg 36.5/100)

URL	Score	Band
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
.../blog/2026-01-12-welcome-to-pelis-agent-factory	41	Foundation
.../blog/2026-01-13-meet-the-workflows-advanced-analytics	41	Foundation
.../blog/2026-01-13-meet-the-workflows-campaigns	41	Foundation
.../blog/2026-01-13-meet-the-workflows-continuous-simplicity	41	Foundation
.../blog/2026-01-13-meet-the-workflows-continuous-style	41	Foundation
.../agent-factory-status	37	Foundation
.../about	35	Critical
.../blog	33	Critical

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 27.3 AIC · ⌖ 11.5 AIC · ⊞ 5K · ◷

• expires on Jul 15, 2026, 8:44 AM UTC-08:00