[geo-optimizer] GEO Audit Report — 2026-06-12 #38886

2026-06-12T17:32:29Z

github-actions[bot]
Bot Jun 12, 2026

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-12
Run: §27431434721

This automated GEO (Generative Engine Optimization) audit evaluates how well the project is positioned for citation by AI engines (ChatGPT, Perplexity, Google AI Overviews, Claude). Both the GitHub README and the documentation site were analysed across 8 signal categories.

Key finding: The docs site is missing its two highest-weight signals — robots.txt and llms.txt — costing it up to 36 points. Fixing these two files alone would lift the entire sitemap average from Critical to at least Foundation.

📊 Scores

Target	Score	Band	Platform Scores (ChatGPT / Perplexity / Google AI)
Docs site (`github.github.com/gh-aw/`)	42/100	Foundation	50 / 65 / 80
README (`github.com/github/gh-aw`)	55/100	Foundation	55 / 70 / 48
Sitemap average (20/187 pages audited)	31.65/100	Critical	—

19 out of 20 sitemap pages score in the Critical band. The homepage is the only page at Foundation level.

✅ Top Strengths

AI bot access (README): GitHub's robots.txt explicitly allows 27 AI crawlers including GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and Anthropic — score 15/18.
llms.txt (README): Present and well-formed — 2,919 words, 12 sections, 117 links, blockquote present — score 14/18.
Meta tags (Docs site): Perfect score 14/14 — title, description, canonical, Open Graph all present.
Schema JSON-LD (Docs site): Rich structured data with WebSite, Organization, SoftwareApplication, and FAQPage types — score 12/16.
Freshness signals (Docs site): Full marks 6/6 — RSS feed at /blog/rss.xml linked in <head>, dateModified present (2026-05-09).
Content depth (README): Perfect 12/12 — 3,092 words, 43 headings, hierarchical structure, front-loaded key content.

🚨 Critical Gaps

No robots.txt on docs site (0/18, −18 pts per page): github.github.com/gh-aw/robots.txt returns 404. AI crawlers have no permission signal. This single file affects all 187 sitemap URLs.
No llms.txt on docs site (0/18, −18 pts per page): github.github.com/gh-aw/llms.txt is absent. Without it, AI engines cannot index a structured summary of the project.
AI Discovery endpoints missing on both sites (0/6 each): Neither /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, nor /ai/service.json exist on either domain.
No Schema JSON-LD on GitHub README (0/16): GitHub.com does not inject JSON-LD, leaving the repository page without WebSite, Organization, or FAQPage schema.
Sitemap-wide Critical band (avg 31.65/100): Every inner page of the docs site scores 27–33. Fixing robots.txt and llms.txt at the site level will cascade across all pages.

🔧 Recommended Fixes

Ordered by impact:

Priority	Fix	Est. Gain	Effort
🔴 1	Add `robots.txt` to docs site allowing all AI bots (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.)	+18 pts/page × all 187 pages	Low
🔴 2	Add `/llms.txt` to docs site (`geo llms --base-url https://github.github.com/gh-aw`)	+up to 18 pts/page	Low
🟠 3	Create AI Discovery files: `/.well-known/ai.txt`, `/ai/summary.json`, `/ai/faq.json`, `/ai/service.json` on docs site	+6 pts on every page	Medium
🟠 4	Add `<link rel="canonical">` to README (currently missing — meta score 11/14 instead of 14/14)	+3 pts	Low
🟡 5	Fix keyword stuffing on README: `issue` at 22.8% density — diversify with "ticket", "request", "task"	Removes −3 penalty	Low
🟡 6	Add numerical statistics to docs site homepage (0 numbers detected; add version count, workflow count, user stats)	+5 pts (content 7→12)	Low
🟡 7	Complete Knowledge Graph sameAs on docs site: add Wikipedia and Crunchbase (currently 2/4: LinkedIn + Wikidata)	+2–4 pts	Low
🟢 8	Add `VideoObject` JSON-LD schema for the 2 videos on docs homepage (no video schema currently)	+1–2 pts	Low
🟢 9	Add WebMCP `toolname`/`tooldescription` attributes to interactive elements for Chrome AI agent support	Future-proofing	Medium
🟢 10	Add CSP and `X-Frame-Options` headers to docs site (present on GitHub.com, missing on docs site)	Trust stack C→B	Medium

📋 Full Breakdown by Category

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

Category	Score	Max	Status
Robots.txt	0	18	❌ File not found
llms.txt	0	18	❌ File not found
Schema JSON-LD	12	16	✅ WebSite, Organization, SoftwareApplication, FAQPage
Meta Tags	14	14	✅ Perfect
Content	7	12	⚠️ 921 words, 0 numbers, not front-loaded (38%)
Signals	6	6	✅ RSS feed + dateModified (2026-05-09)
AI Discovery	0	6	❌ No /.well-known/ai.txt or /ai/*.json
Brand & Entity	6	10	⚠️ 2/4 KG pillars, no about link
Negative Penalty	−3	—	⚠️ Keyword stuffing + hidden text

Trust Stack: C (15/25) — Social 4/5, Consistency 4/5, but Academic 1/5 (no statistics in content)

WebMCP: basic readiness — SearchAction potential action found, but no toolname attributes, no OpenAPI spec

RAG Chunk Readiness: 45/100 — avg section 6.5 words (too short for RAG retrieval), 0/8 sections in optimal word range

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

Category	Score	Max	Status
Robots.txt	15	18	✅ 27 AI bots allowed (not explicitly listed — implicit allow)
llms.txt	14	18	✅ 2,919 words, 12 sections, 117 links
Schema JSON-LD	0	16	❌ GitHub.com provides none
Meta Tags	11	14	⚠️ Missing canonical
Content	12	12	✅ 3,092 words, 43 headings, front-loaded
Signals	3	6	⚠️ No RSS, no dateModified in schema
AI Discovery	0	6	❌ No AI endpoints
Brand & Entity	3	10	❌ No KG pillars, no contact info in schema
Negative Penalty	−3	—	⚠️ Keyword stuffing (issue 22.8%) + hidden text + 12 broken links

Trust Stack: C (16/25) — Academic 4/5 (481 numbers, 5 external links, 4 original stats), but Social 1/5

Citability: README 84/100; Docs site 81/100

Content Decay: HIGH risk on README (temporal/version references detected; earliest decay 180 days); LOW on docs site (evergreen score 100)

Context Window: README optimised for ChatGPT + Claude (4,009 tokens, medium truncation risk); Docs site optimal for all three platforms (1,190 tokens, low truncation risk)

📄 Sitemap Page Scores (20 of 187 audited)

Page	Score	Band
`/` (homepage)	42	Foundation
`/blog`	33	Critical
`/blog/3`, `/blog/4`, `/blog/8`	33	Critical
`/blog/2`, `/blog/5`, `/blog/6`	32	Critical
`/blog/7`	31	Critical
`/blog/9` and blog posts (×9)	30	Critical
`/agent-factory-status`	27	Critical

Common pattern: All inner pages score 0 for Robots, llms, and AI Discovery — the same missing files as the homepage. Meta tags consistently score 14/14 (the Astro theme generates excellent meta output). Schema JSON-LD is absent on all inner pages (only homepage has it).

Once robots.txt and llms.txt are added, every page immediately gains up to +36 points before any other change.

⚠️ Sitemap contains 187 URLs total; only 20 were audited in this run (--max-urls cap). Consider increasing the cap for a full-site audit.

References:

§27431434721

Generated by 🌍 GEO Optimizer Daily Audit · 218.3 AIC · ⌖ 13.8 AIC · ⊞ 17.1K · ◷

expires on Jun 15, 2026, 9:32 AM UTC-08:00

2026-06-15T18:11:01Z

github-actions[bot]
Bot Jun 15, 2026
Author

This discussion was automatically closed because it expired on 2026-06-15T17:32:29.063Z.

Closed by Workflow

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[geo-optimizer] GEO Audit Report — 2026-06-12 #38886

Uh oh!

{{title}}

Uh oh!

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

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

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

[geo-optimizer] GEO Audit Report — 2026-06-12 #38886

Uh oh!

github-actions[bot] Bot Jun 12, 2026

GEO Audit Report — github/gh-aw

📊 Scores

✅ Top Strengths

🚨 Critical Gaps

🔧 Recommended Fixes

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

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

Replies: 1 comment

Uh oh!

github-actions[bot] Bot Jun 15, 2026 Author

github-actions[bot]
Bot Jun 12, 2026

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

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

github-actions[bot]
Bot Jun 15, 2026
Author