[geo-optimizer] GEO Audit Report — 2026-05-18

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-05-18
Run: §26048861792

---

📊 Scores

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

---

✅ Top Strengths

• Meta tags scoring well (14/max) on both docs site and README — <title>, <description>, and Open Graph tags are present
• Content quality contributing positively (11–12/max) — structured, readable content that AI crawlers can parse
• Schema JSON-LD partially present on the docs homepage (12/max) — some structured data already implemented
• Brand & entity signals contributing positively on the docs homepage (6/max)
• Author signal present on the README page

---

🚨 Critical Gaps

1. No robots.txt AI allowances — Score: 0/max on both targets. Missing explicit Allow rules for GPTBot, ClaudeBot, PerplexityBot means AI crawlers may be blocked or uncertain about permission.
2. No llms.txt file — Score: 0/max on both targets. This organizational signal is absent across the entire docs site.
3. No AI discovery endpoints — Score: 0/max sitewide. Missing /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json.
4. Keyword stuffing detected — 'github' at 3.7% density on the docs site; 'issue' at 23.5% density on the README. AI engines may penalize over-repetition.
5. 12 broken links on README — Broken links reduce trust signals and AI-engine confidence in the page.
6. Sitemap pages mostly Critical band — 19 of 20 audited pages score in the Critical band (avg 31.6/100), indicating systemic gaps beyond just the homepage.

---

🔧 Recommended Fixes

Ordered by impact:

1. Add robots.txt with AI bot Allow rules — Explicitly allow GPTBot, ClaudeBot, PerplexityBot, Google-Extended. High-impact, one-time change.
2. Create /llms.txt — Run geo llms --base-url https://github.github.com/gh-aw to generate. Helps AI systems structure their understanding of the site.
3. Create /.well-known/ai.txt — Define AI crawler permissions in the standard location.
4. Add AI discovery JSON files — Create /ai/summary.json, /ai/faq.json, /ai/service.json with structured project descriptions, FAQs, and service capabilities.
5. Fix broken links in README — 12 broken links reduce trust scores. Run a link checker and update/remove stale links.
6. Add sameAs Knowledge Graph links — Add Wikipedia, Wikidata, LinkedIn, or Crunchbase links to Organization schema for entity disambiguation.
7. Add WebSite and FAQPage JSON-LD schemas — README is missing Organization and WebSite structured data; docs pages missing FAQPage schema.
8. Add canonical tags to README — Prevents duplicate content issues in AI indexing.
9. Diversify vocabulary — Reduce keyword density for 'github' and 'issue' in README/docs content.

📋 Full Score Breakdown by Category

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

Category	Score	Notes
Robots.txt	0	Missing AI bot Allow rules
llms.txt	0	File not present
Schema JSON-LD	12	Partial structured data present
Meta Tags	14	Title, description, OG tags present
Content	11	Good structure, keyword stuffing flag
Signals	6	Some trust signals
AI Discovery	0	No /.well-known/ai.txt or /ai/*.json
Brand & Entity	6	Partial sameAs links (2/4)
Negative Penalty	-3	Keyword stuffing, hidden text detected

Negative signals (medium severity): keyword stuffing, hidden text (display:none)

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

Category	Score	Notes
Robots.txt	15	GitHub.com provides baseline
llms.txt	14	GitHub.com provides baseline
Schema JSON-LD	0	No Organization/WebSite schema
Meta Tags	11	Present but no canonical tag
Content	12	Readable content
Signals	3	Limited trust signals
AI Discovery	0	No AI-specific endpoints
Brand & Entity	3	No sameAs links
Negative Penalty	-3	Keyword stuffing (23.5% 'issue'), 12 broken links, popup signals

Negative signals (medium severity): keyword stuffing, broken links (12), popup signals

📄 Sitemap Page Scores (20 pages audited)

Average score: 31.6/100 (Critical band)
Band distribution: 1 Foundation, 19 Critical

Top Pages

URL	Score	Band
github.github.com/gh-aw	46	Foundation
github.github.com/gh-aw/blog	33	Critical
github.github.com/gh-aw/blog/2	33	Critical
github.github.com/gh-aw/blog/5	33	Critical
github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-improvement	33	Critical

Worst Pages

URL	Score	Band
github.github.com/gh-aw/agent-factory-status	27	Critical
...meet-the-workflows-metrics-analytics	30	Critical
...meet-the-workflows-interactive-chatops	30	Critical
...meet-the-workflows-documentation	30	Critical
...meet-the-workflows-creative-culture	30	Critical

All blog and interior pages score 0 on Robots.txt, llms.txt, Schema, and AI Discovery — the sitewide gaps dominate page scores.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · ● 3.2M · ◷

• expires on May 21, 2026, 5:22 PM UTC

[github-actions[bot]]

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

A newer discussion is available at Discussion #33598.