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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-09
Run: §29035910430

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	43/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Docs sitemap average (20 pages)	36/100	Foundation/Critical

---

✅ Top Strengths

• Meta tags (docs site): 14/14 — Title, description, canonical, OG tags, and OG image are all present and well-formed.
• Robots.txt (README): 15/18 — GitHub's global robots.txt explicitly allows 27 AI bots (GPTBot, ClaudeBot, PerplexityBot, and more).
• llms.txt (README): 14/18 — A rich llms.txt exists with 12 sections, 117 links, 2,919 words, and blockquote summaries.
• Signals (docs site): 6/6 — Language tag, RSS feed, and freshness date are all present.
• Schema JSON-LD (docs site): 12/16 — WebSite, Organization, SoftwareApplication, and FAQPage types are implemented.
• Content (README): 12/12 — Good heading hierarchy, lists/tables, front-loaded content, numbers, and sufficient word count.

---

🚨 Critical Gaps

1. robots.txt missing on docs site (0/18) — github.github.com has no robots.txt, so AI crawlers have no explicit permission signal. This is the single largest point loss.
2. llms.txt missing on docs site (0/18) — No llms.txt at https://github.github.com/gh-aw/llms.txt. This organizational signal would help AI systems structure and cite the docs.
3. AI discovery endpoints missing everywhere (0/6 on both targets) — Neither site has /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json.
4. Schema JSON-LD absent on README page (0/16) — GitHub's repository page carries no JSON-LD schema at all (WebSite, Organization, FAQPage are all missing).
5. Brand & Entity weak on README page (3/10) — No Knowledge Graph pillar links (Wikipedia, Wikidata, LinkedIn, Crunchbase) and no sameAs in schema, making entity disambiguation difficult for AI engines.

---

🔧 Recommended Fixes

Ordered by estimated score impact:

1. Add robots.txt to docs site (+up to 18 pts) — Create https://github.github.com/gh-aw/robots.txt with explicit Allow rules for GPTBot, ClaudeBot, PerplexityBot, and other AI bots. Run: gh aw compile after updating the Docusaurus config.
2. Generate llms.txt for the docs site (+up to 18 pts) — Run geo llms --base-url https://github.github.com/gh-aw and publish the output at /llms.txt. Ensures AI systems can ingest a structured, link-rich summary of all docs.
3. Create AI discovery endpoints on the docs site (+6 pts) — Add /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json under github.github.com/gh-aw/.
4. Add JSON-LD schema to docs site pages (+up to 4 pts on sub-pages) — Most blog and doc sub-pages score 0 on schema; add at minimum Article or TechArticle schema per page.
5. Add WebSite + Organization JSON-LD to README (+16 pts potential) — While GitHub controls the rendering, project-level schema signals can be embedded in the repo's GitHub Pages or docs site to strengthen entity signals.
6. Fix broken links (13 detected on README page) — Broken links are a negative signal; audit and fix or redirect them.
7. Reduce keyword density for "github" (2.7–2.8%) — Diversify vocabulary to avoid keyword-stuffing penalties.
8. Add liveDemo / WebMCP attributes — Add toolname/tooldescription attributes to interactive elements for Chrome AI agent support.

📋 Full Breakdown by Category

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

Category	Score	Max	Status
Robots.txt	0	18	❌ Missing
llms.txt	0	18	❌ Missing
Schema JSON-LD	12	16	✅ Good
Meta Tags	14	14	✅ Perfect
Content	7	12	⚠️ Partial
Signals	6	6	✅ Perfect
AI Discovery	0	6	❌ Missing
Brand & Entity	7	10	⚠️ Partial
Negative Penalty	-3	—	⚠️ Medium

Negative signals: keyword stuffing (github at 2.8% density), no author signal.

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

Category	Score	Max	Status
Robots.txt	15	18	✅ Good
llms.txt	14	18	✅ Good
Schema JSON-LD	0	16	❌ Missing
Meta Tags	11	14	✅ Good
Content	12	12	✅ Perfect
Signals	3	6	⚠️ Partial (no RSS, no freshness date)
AI Discovery	0	6	❌ Missing
Brand & Entity	3	10	❌ Weak
Negative Penalty	-3	—	⚠️ Medium

Negative signals: 13 broken links, keyword stuffing (github at 2.7% density), popup signals detected.

📄 Sitemap Page Scores (20 pages audited)

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

Top performing pages:

Page	Score	Band
/blog/2026-01-13-meet-the-workflows-continuous-improvement	44	Foundation
/ (home)	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 performing pages:

Page	Score	Band
/blog/10	30	Critical
/blog/8	31	Critical
/blog/7	32	Critical
/blog/6	32	Critical
/blog/3	32	Critical

Sitemap average score breakdown (all 20 pages): robots=0, llms=0, schema=4.2, meta=14.0, content=10.65, signals=5.4, ai_discovery=0, brand_entity=3.2, negative_penalty=-1.0

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 35.9 AIC · ⌖ 12.4 AIC · ⊞ 4.9K · ◷

• expires on Jul 12, 2026, 9:18 AM UTC-08:00