[geo-optimizer] GEO Audit Report — 2026-05-05 #30401

2026-05-05T17:01:08Z

github-actions[bot]
Bot May 5, 2026

GEO Audit Report — github/gh-aw

Audit Date: 2026-05-05
Run: §25390152228

📊 Scores

Target	Score	Band
Docs site (`github.github.com/gh-aw/`)	28/100	🔴 Critical
README (`github.com/github/gh-aw`)	58/100	🟡 Foundation

✅ Top Strengths

README robots.txt: 27 AI bots explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.) — scored 15/18
README llms.txt: Present with 2,742 words, 12 sections, and 112 links — scored 14/18
Docs site meta tags: Perfect score (14/14) — title, description, canonical, and all Open Graph tags present
Docs site content accessibility: Rendered by Astro, fully readable without JS — 1,048 words, 24 headings
README content richness: Full score (12/12) — front-loaded, has numbers (464), headings, lists/tables

🚨 Critical Gaps

No JSON-LD schema on either target (0/16): No WebSite, WebApplication, FAQPage, or Organization schema — the single highest-impact gap for AI Knowledge Graph inclusion
Docs site has no robots.txt (0/18): AI crawlers are not explicitly allowed on the docs site — despite no blocking, lack of explicit Allow rules reduces indexing confidence
No llms.txt on docs site (0/18): The README has one, but github.github.com/gh-aw/ lacks /llms.txt
No AI discovery endpoints (0/6 on both): /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json are all absent on both targets
Docs site sitemap missing (404): github.github.com/gh-aw/sitemap.xml returned 404 — AI crawlers cannot discover interior pages automatically

🔧 Recommended Fixes

Ordered by estimated impact:

Add JSON-LD schema markup (both targets, highest impact)
- Add WebSite + Organization schemas to docs site homepage
- Add FAQPage schema populated from existing docs FAQ content
- Include potentialAction (SearchAction) for agent discoverability

Create /llms.txt on docs site (potential +18 pts)

geo llms --base-url https://github.github.com/gh-aw

Add robots.txt to docs site (potential +18 pts)
- Explicitly allow: GPTBot, ClaudeBot, PerplexityBot, Google-Extended
Add /.well-known/ai.txt on docs site (+6 pts)
- Defines AI crawler permissions in a structured format
Create /ai/summary.json, /ai/faq.json, /ai/service.json on docs site
- Structured endpoints for AI engine discovery
Fix sitemap on docs site
- Investigate why sitemap.xml returns 404 (Astro Starlight should auto-generate it)
- Ensure <link rel="sitemap"> is in <head>
README: add canonical URL and RSS feed link
- Missing canonical; would remove duplicate content risk
- Add <link rel="alternate" type="application/rss+xml"> in <head>
Address content decay signals on README (evergreen score: 38/100)
- Add dateModified schema to signal freshness to AI engines

📋 Full Category Breakdown

Docs Site (`github.github.com/gh-aw/`) — 28/100 Critical

Category	Score	Max	Notes
Robots.txt	0	18	No robots.txt found
llms.txt	0	18	No llms.txt found
Schema JSON-LD	0	16	No schema types detected
Meta Tags	14	14	✅ Perfect
Content	7	12	No numbers/stats; no front-loading
Signals	5	6	Has RSS; missing freshness date
AI Discovery	0	6	No well-known/ai.txt, no summary/faq/service
Brand & Entity	2	10	Brand name consistent; missing schema/KG/about/contact

Trust Grade: D (9/25) — Low trust level
Platform Citation Scores: ChatGPT 25/100 · Perplexity 50/100 · Google AI 50/100
Negative signals: Keyword stuffing (github at 3.2% density); hidden text (CtrlK element)
RAG Chunk Readiness: 45/100 — avg section only 5.9 words; needs larger semantic chunks
Context Window: 1,048 words / ~1,362 tokens — optimal for Perplexity, ChatGPT, Claude

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

Category	Score	Max	Notes
Robots.txt	15	18	✅ 27 AI bots allowed; not fully explicit
llms.txt	14	18	✅ 12 sections, 112 links; missing `/llms-full.txt` and optional section
Schema JSON-LD	0	16	No schema types detected
Meta Tags	11	14	Missing canonical URL
Content	12	12	✅ Perfect — front-loaded, numbers, lists
Signals	3	6	Has lang; no RSS; no freshness date
AI Discovery	0	6	No AI discovery endpoints
Brand & Entity	3	10	Brand consistent + about page + author; no KG/social schema

Trust Grade: C (16/25) — Medium trust level
Platform Citation Scores: ChatGPT 55/100 · Perplexity 70/100 · Google AI 45/100
Negative signals: Keyword stuffing (issue at 22.2%); hidden text; popup signals; 12 broken links
Content Decay Risk: High — evergreen score 38/100 (many temporal references, version numbers)
RAG Chunk Readiness: 46/100 — only 1/26 sections in ideal word range

📄 Sitemap Page Scores

The docs sitemap audit failed — https://github.github.com/gh-aw/sitemap.xml returned a 404 Not Found error. No individual page scores are available.

Action required: Verify that Astro Starlight sitemap generation is enabled in astro.config.mjs and that the built site includes sitemap.xml. This also prevents the <link rel="sitemap"> hint from being present in <head>.

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

Generated by GEO Optimizer Daily Audit · ● 649.2K · ◷

expires on May 8, 2026, 5:01 PM UTC

pelikhan · 2026-05-06T01:48:34Z

pelikhan
May 6, 2026
Maintainer

/plan

1 reply

github-actions[bot] Bot May 6, 2026
Author

🚀 Plan Command has started processing this discussion comment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[geo-optimizer] GEO Audit Report — 2026-05-05 #30401

Uh oh!

{{title}}

Uh oh!

Docs Site (`github.github.com/gh-aw/`) — 28/100 Critical

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

Replies: 1 comment 1 reply

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

[geo-optimizer] GEO Audit Report — 2026-05-05 #30401

Uh oh!

github-actions[bot] Bot May 5, 2026

GEO Audit Report — github/gh-aw

📊 Scores

✅ Top Strengths

🚨 Critical Gaps

🔧 Recommended Fixes

Docs Site (github.github.com/gh-aw/) — 28/100 Critical

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

Replies: 1 comment · 1 reply

Uh oh!

pelikhan May 6, 2026 Maintainer

Uh oh!

github-actions[bot] Bot May 6, 2026 Author

github-actions[bot]
Bot May 5, 2026

Docs Site (`github.github.com/gh-aw/`) — 28/100 Critical

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

Replies: 1 comment 1 reply

pelikhan
May 6, 2026
Maintainer

github-actions[bot] Bot May 6, 2026
Author