[geo-optimizer] GEO Audit Report — 2026-06-22 #40832

2026-06-22T18:00:23Z

github-actions[bot]
Bot Jun 22, 2026

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-22
Run: §27972910455

📊 Scores

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

✅ Top Strengths

README robots.txt is exemplary — 27 AI bots explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, xAI-Bot, etc.) scoring 15/18.
README llms.txt is solid — 12 sections, 117 links, 2,919 words; scoring 14/18, well-indexed for LLM consumption.
Docs site meta tags are perfect — title, description, canonical, and all Open Graph tags score 14/14.
Docs site JSON-LD schema is rich — WebSite, Organization, SoftwareApplication, and FAQPage types all present; 12/16.
Docs site freshness signals are complete — language tag, RSS feed, and dateModified all present; 6/6.
No AI bots are blocked anywhere — crawl access is open for all major AI engines.
Content is JS-independent — both targets serve full content in raw HTML (SSR-safe).

🚨 Critical Gaps

Docs site has no robots.txt — 0/18. AI bots are not explicitly permitted, leaving crawl access implicit and unverified. All 20 sitemap pages audited share this gap.
Docs site has no llms.txt — 0/18. The entire github.github.com/gh-aw/ property has no machine-readable AI site manifest. This is the single highest-impact missing file.
AI Discovery endpoints missing everywhere — both targets score 0/6. No /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, or /ai/service.json exist on either domain.
README has zero JSON-LD schema — 0/16. While GitHub's platform constrains head injection, the README itself contains no structured data, severely limiting Google AI / Bing AI entity recognition.
Docs site content lacks quantitative data — has_numbers: false, 0 statistics found. AI engines strongly prefer content with concrete numbers and metrics (+40% citation likelihood per audit signal).
Brand entity score is weak on README — 3/10. No sameAs schema links, no Knowledge Graph pillar anchors, no contact information in schema.
Hidden text detected on both targets — flagged as medium-risk cloaking pattern by AI crawlers (display:none content). The docs site has a keyboard shortcut label ("CtrlK"); the README has a GitHub navigation block.

🔧 Recommended Fixes

Ordered by estimated score impact:

Priority	Action	Est. Gain	Target
🔴 1	Create `robots.txt` on `github.github.com/gh-aw/` explicitly allowing GPTBot, ClaudeBot, PerplexityBot, Google-Extended	+18 pts	Docs site + all sitemap pages
🔴 2	Generate `/llms.txt`: run `geo llms --base-url https://github.github.com/gh-aw` and deploy	+18 pts	Docs site + all sitemap pages
🟠 3	Create `/.well-known/ai.txt`, `/ai/summary.json`, `/ai/faq.json`, `/ai/service.json` on docs site	+6 pts	Docs site
🟠 4	Add `WebSite`, `Organization`, and `FAQPage` JSON-LD schema to README (via a schema-injecting action or pinned Gist referenced in llms.txt)	+16 pts	README
🟠 5	Add concrete statistics/numbers to docs site homepage — e.g., number of workflows, actions run count, supported AI models	+5 pts	Docs site
🟡 6	Align schema `description` with meta `description` on docs site (currently mismatched)	+1-2 pts	Docs site
🟡 7	Add `<link rel="alternate" type="application/rss+xml">` to README `<head>` for AI freshness signals	+3 pts	README
🟡 8	Add `VideoObject` schema for the 2 videos on docs site homepage (name, description, thumbnailUrl, uploadDate)	+2 pts	Docs site
🟡 9	Add `sameAs` links in Organization schema pointing to Wikipedia/Wikidata/LinkedIn to improve Knowledge Graph disambiguation	+2-3 pts	Docs site
⚪ 10	Add `Content-Security-Policy` and `X-Frame-Options` headers on docs site to reach full technical trust score	Trust +2	Docs site

📋 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	✅ WebSite, Org, SoftwareApp, FAQPage
Meta Tags	14	14	✅ Perfect
Content	7	12	⚠️ No numbers/stats; no front-loading
Signals	6	6	✅ Perfect (lang, RSS, freshness)
AI Discovery	0	6	❌ No well-known/ai.txt, no /ai/* endpoints
Brand & Entity	7	10	⚠️ No about link; schema↔meta desc mismatch
Negative Penalty	-3	—	⚠️ Hidden text, keyword stuffing ("github" 2.8%)

Platform citation scores (docs site): ChatGPT 50 · Perplexity 65 · Google AI 80
Trust grade: C (Technical 3/5, Identity 3/5, Social 4/5, Academic 1/5, Consistency 4/5)
RAG chunk readiness: 45/100 — avg section only 6.5 words; needs richer prose sections
WebMCP: basic (no tool attributes, no OpenAPI)

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

Category	Score	Max	Status
Robots.txt	15	18	✅ 27 bots allowed
llms.txt	14	18	✅ 12 sections, 117 links
Schema JSON-LD	0	16	❌ No structured data
Meta Tags	11	14	⚠️ Missing canonical URL
Content	12	12	✅ Perfect (headings, numbers, lists)
Signals	3	6	⚠️ No RSS, no freshness date
AI Discovery	0	6	❌ No well-known/ai.txt, no /ai/* endpoints
Brand & Entity	3	10	❌ No KG pillars, no sameAs, no contact schema
Negative Penalty	-3	—	⚠️ Hidden nav text, keyword stuffing ("issue" 22.5%), 12 broken links

Platform citation scores (README): ChatGPT 55 · Perplexity 70 · Google AI 48
Trust grade: C (Technical 5/5 ✅, Identity 3/5, Social 1/5, Academic 4/5, Consistency 3/5)
Content decay risk: High — version strings ("v0.80.9", "Jun 22, 2026") will become stale
RAG chunk readiness: 46/100 — avg section 23.8 words; only 1/26 sections in optimal range

📄 Sitemap Page Scores (20 of 191 pages audited)

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

⚠️ All 20 audited pages score 0 on Robots.txt, llms.txt, and AI Discovery — these are structural gaps that affect the entire site.

Top pages:

URL	Score	Band
`/blog/2026-01-13-meet-the-workflows-continuous-improvement`	44	Foundation
`/` (homepage)	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 pages (paginated blog index pages lack any JSON-LD schema):

URL	Score	Band
`/blog/7`	30	Critical
`/blog/6`	32	Critical
`/blog/9`	32	Critical
`/blog/5`	33	Critical
`/blog/8`	33	Critical

The paginated blog index pages (/blog/2–/blog/9) consistently miss JSON-LD schema (schema: 0/16) — adding BlogPosting or ItemList schema to the blog index template would lift these pages out of Critical band.

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

Generated by 🌍 GEO Optimizer Daily Audit · 28.5 AIC · ⌖ 14.2 AIC · ⊞ 4.5K · ◷

expires on Jun 25, 2026, 10:00 AM UTC-08:00

2026-06-23T17:14:13Z

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

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

A newer discussion is available at Discussion #41085.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[geo-optimizer] GEO Audit Report — 2026-06-22 #40832

Uh oh!

{{title}}

Uh oh!

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

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

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

[geo-optimizer] GEO Audit Report — 2026-06-22 #40832

Uh oh!

github-actions[bot] Bot Jun 22, 2026

GEO Audit Report — github/gh-aw

📊 Scores

✅ Top Strengths

🚨 Critical Gaps

🔧 Recommended Fixes

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

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

Replies: 1 comment

Uh oh!

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

github-actions[bot]
Bot Jun 22, 2026

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

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

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