[geo-optimizer] GEO Audit Report — 2026-06-24 #41270

2026-06-24T17:09:11Z

github-actions[bot]
Bot Jun 24, 2026

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-24
Run: §28115608005

📊 Scores

Target	Score	Band
Docs site (`github.github.com/gh-aw/`)	43/100	Foundation
README (`github.com/github/gh-aw`)	55/100	Foundation
Sitemap average (20/191 pages audited)	37/100	Foundation/Critical

✅ Top Strengths

README robots.txt is excellent (15/18) — 27 AI crawlers explicitly allowed, including GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and 23 others.
README llms.txt is well-structured (14/18) — 2,919 words, 12 sections, 117 links; gives LLMs a clear navigation map of the project.
Docs site meta tags are perfect (14/14) — title, description, canonical, OG tags all present and well-formed.
Docs site signals are perfect (6/6) — lang="en", RSS feed, and dateModified freshness all in place.
Docs site Schema JSON-LD is strong (12/16) — WebSite, Organization, SoftwareApplication, and FAQPage types detected.
All content is SSR-safe — Both targets serve full content without JavaScript, ensuring AI crawlers see the same content as users.
Platform citation readiness — Perplexity scores 65 (docs) / 70 (README); Google AI Overviews scores 80/100 for the docs site.

🚨 Critical Gaps

Docs site has no robots.txt (0/18) — AI crawlers receive no explicit permissions, a critical signal gap that affects all 191 sitemap pages.
Docs site has no llms.txt (0/18) — No LLM-friendly index exists for the documentation site, unlike the README.
README has zero JSON-LD schema (0/16) — No WebSite, Organization, or FAQPage structured data; GitHub.com is a platform page and does not inject schema for repos.
AI Discovery endpoints missing on both targets (0/6 each) — No /.well-known/ai.txt, no /ai/summary.json, /ai/faq.json, or /ai/service.json.
Sitemap: 50% of audited pages in Critical band — Blog pagination pages (/blog/2 through /blog/9) all score 30–33/100 with 0 robots, 0 llms, 0 schema, and 0 ai_discovery.
Negative signals — Docs site: keyword stuffing (github 2.8%), hidden text. README: 12 broken links, keyword stuffing (issue 22.7%), popup signals.

🔧 Recommended Fixes

Ordered by estimated impact:

#	Fix	Target	Est. Gain
1	Add `robots.txt` allowing AI bots (`GPTBot`, `ClaudeBot`, `PerplexityBot`, `Google-Extended`, etc.)	Docs site	+18 pts per page
2	Generate `llms.txt` via `geo llms --base-url https://github.github.com/gh-aw`	Docs site	+14–18 pts per page
3	Add JSON-LD schema — WebSite, Organization (with `sameAs`), FAQPage — to the README (via repo `<head>` or docs site only)	README / docs	+16 pts README
4	Create AI discovery endpoints: `/.well-known/ai.txt`, `/ai/summary.json`, `/ai/faq.json`, `/ai/service.json`	Both	+6 pts each
5	Add `<link rel="canonical">` to the GitHub README page	README	+3 pts
6	Add RSS feed `<link rel="alternate">` to README `<head>`	README	+2 pts
7	Add numerical statistics to docs site homepage content (e.g., workflow counts, performance metrics)	Docs site	+content score
8	Fix 12 broken links detected in README	README	reduces -penalty
9	Add `WebApplication` JSON-LD type to docs site schema (currently missing from the 4 found types)	Docs site	+4 pts
10	Add `VideoObject` schema for the 2 embedded videos on the docs site (name, description, thumbnailUrl, uploadDate)	Docs site	+schema points

Quick win: Items 1 & 2 together could lift the docs site from 43 → ~75/100 and all 191 sitemap pages from a 37 average to near 50+.

📋 Full Breakdown by Category

Docs Site (`github.github.com/gh-aw/`)

Category	Score	Max	Notes
Robots.txt	0	18	File not found
llms.txt	0	18	File not found
Schema JSON-LD	12	16	WebSite, Organization, SoftwareApplication, FAQPage ✅; WebApp missing
Meta Tags	14	14	✅ Perfect
Content	7	12	No numbers/stats, no tables/lists, no front-loading
Signals	6	6	✅ Perfect — lang, RSS, freshness
AI Discovery	0	6	No well-known/ai.txt, no summary/faq/service JSON
Brand & Entity	7	10	Wikipedia/Wikidata/LinkedIn/Crunchbase ✅; missing about link, geo schema
Negative Penalty	-3	—	Keyword stuffing (`github` 2.8%), hidden text

Trust Stack: C grade (15/25) — Social trust strong (4/5), Academic trust weak (1/5, no statistics)

Platform Citation Scores: ChatGPT 50 · Perplexity 65 · Google AI 80

Context Window: 918 words / ~1,193 tokens — low truncation risk, optimal for all major LLMs

RAG Chunk Readiness: 45/100 — avg section is only 6.5 words; sections need more depth

WebMCP: Basic readiness; SearchAction potential action detected but no tool attributes

README (`github.com/github/gh-aw`)

Category	Score	Max	Notes
Robots.txt	15	18	✅ 27 AI bots explicitly allowed
llms.txt	14	18	✅ 2,919 words, 12 sections, 117 links; `llms-full.txt` missing
Schema JSON-LD	0	16	❌ No JSON-LD on github.com repo pages
Meta Tags	11	14	No canonical URL
Content	12	12	✅ Perfect — numbers, lists, tables, front-loading
Signals	3	6	No RSS feed, no freshness date
AI Discovery	0	6	No well-known/ai.txt, no summary/faq/service JSON
Brand & Entity	3	10	No KG pillar links, no Wikipedia/Wikidata in schema
Negative Penalty	-3	—	12 broken links, popup signals, `issue` keyword 22.7%

Trust Stack: C grade (16/25) — Technical trust perfect (5/5), Social trust weak (1/5)

Platform Citation Scores: ChatGPT 55 · Perplexity 70 · Google AI 48

Context Window: 2,916 words / ~3,790 tokens — medium truncation risk

Content Decay Risk: High — version references (v0.80.9) and temporal strings may stale quickly

RAG Chunk Readiness: 46/100 — only 1 section in optimal word-count range (avg 23.8 words/section)

📄 Sitemap Page Scores (20 of 191 audited)

Average score: 37/100 · Band distribution: 10 Foundation, 10 Critical

Universal gap: robots=0, llms=0, ai_discovery=0 across ALL 20 audited pages — these three categories alone account for 42 out of 100 possible points.

Top 5 Pages

URL	Score	Band
`/blog/2026-01-13-...-continuous-improvement`	44	Foundation
`/` (homepage)	43	Foundation
`/blog/2026-01-13-...-continuous-refactoring`	43	Foundation
`/blog/2026-01-12-welcome-to-pelis-agent-factory`	41	Foundation
`/blog/2026-01-13-...-advanced-analytics`	41	Foundation

Bottom 5 Pages

URL	Score	Band
`/blog/7`	30	Critical
`/blog/6`	32	Critical
`/blog/9`	32	Critical
`/blog/4`, `/blog/5`, `/blog/8`	33	Critical
`/blog` (index), `/blog/2`, `/blog/3`	33	Critical

Blog pagination pages have 0 schema (no JSON-LD), 0 robots, 0 llms — adding robots.txt and llms.txt site-wide would immediately lift these.

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

Generated by 🌍 GEO Optimizer Daily Audit · 28.7 AIC · ⌖ 13.2 AIC · ⊞ 4.6K · ◷

expires on Jun 27, 2026, 9:09 AM UTC-08:00

2026-06-27T17:31:39Z

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

This discussion was automatically closed because it expired on 2026-06-27T17:09:11.415Z.

Closed by Workflow

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[geo-optimizer] GEO Audit Report — 2026-06-24 #41270

Uh oh!

{{title}}

Uh oh!

Docs Site (`github.github.com/gh-aw/`)

README (`github.com/github/gh-aw`)

Top 5 Pages

Bottom 5 Pages

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

[geo-optimizer] GEO Audit Report — 2026-06-24 #41270

Uh oh!

github-actions[bot] Bot Jun 24, 2026

GEO Audit Report — github/gh-aw

📊 Scores

✅ Top Strengths

🚨 Critical Gaps

🔧 Recommended Fixes

Docs Site (github.github.com/gh-aw/)

README (github.com/github/gh-aw)

Top 5 Pages

Bottom 5 Pages

Replies: 1 comment

Uh oh!

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

github-actions[bot]
Bot Jun 24, 2026

Docs Site (`github.github.com/gh-aw/`)

README (`github.com/github/gh-aw`)

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