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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-05-29
Run: §26652275724

---

📊 Scores

Target	Score	Band
Docs site (github.github.com/gh-aw/)	42/100	Foundation
README (github.com/github/gh-aw)	55/100	Foundation
Sitemap avg (20 pages)	31.5/100	Critical

19 out of 20 documentation pages scored in the Critical band. Only the homepage reaches Foundation.

---

✅ Top Strengths

• README: robots.txt & llms.txt present — scores 15/15 and 14/15 respectively; AI crawlers are explicitly permitted
• README: Academic trust strong — 478 numbers cited, references section, 4 statistics patterns; academic trust score 4/5
• README: Full technical security headers — HTTPS, HSTS, CSP, X-Frame-Options all present (5/5 technical trust)
• Docs site: Social trust (4/5) — 6 sameAs links, 3+ Knowledge Graph links, reviews/testimonials present
• Docs site: Meta tags (14/15) — Well-structured meta tags on the homepage
• Docs site: Organization JSON-LD schema — Some structured data is present (schema score 12)

---

🚨 Critical Gaps

1. Zero AI Discovery (0/max across all pages) — No /.well-known/ai.txt, no /ai/summary.json, /ai/faq.json, or /ai/service.json on either the docs site or README
2. Zero robots.txt & llms.txt on docs site — The entire docs site scores 0/15 for robots and 0/15 for llms.txt; AI crawlers have no explicit permission or structure guidance
3. Zero schema JSON-LD on most docs pages — 19/20 pages score 0 on schema; only the homepage has partial structured data
4. Keyword stuffing penalties — 'github' at 2.7% density on docs site; 'issue' at 22.8% density on README — both triggering negative penalties
5. No canonical tags on README — Missing <link rel="canonical"> risking duplicate content penalties in AI indexing
6. 12 broken links on README — Contributing to negative trust signals; popup signals also detected

---

🔧 Recommended Fixes

Ordered by estimated impact:

1. Add robots.txt to docs site with explicit Allow rules for GPTBot, ClaudeBot, PerplexityBot — fixes 0→15 on robots score for all pages
2. Add llms.txt to docs site via geo llms --base-url https://github.github.com/gh-aw — fixes 0→14 on llms score for all pages
3. Add AI discovery endpoints (/.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json) to docs site — fixes 0→max on AI Discovery for all pages
4. Add JSON-LD schema to all docs pages — minimum: WebPage + BreadcrumbList per page; Article schema for blog posts; FAQPage schema for FAQ sections
5. Add <link rel="canonical"> to README and fix the 12 broken links
6. Add Organization JSON-LD with sameAs links to README (Wikipedia, Wikidata, LinkedIn, Crunchbase) — fixes README social trust (currently 1/5)
7. Diversify keyword usage in README — 'issue' at 22.8% is extreme stuffing; replace with synonyms (request, ticket, task, report)
8. Add /about page link to docs site navigation — missing identity trust signal
9. Add dateModified to README schema and ensure schema description matches meta description

📋 Full Breakdown by Category

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

Category	Score	Notes
Robots	0	No robots.txt
llms.txt	0	No llms.txt
Schema JSON-LD	12	Organization schema present, missing WebSite schema
Meta Tags	14	Well-structured
Content	7	Keyword stuffing (github 2.7%), no stats/numbers
Signals	6	—
AI Discovery	0	No ai.txt, no /ai/ endpoints
Brand & Entity	6	sameAs links present (6), but missing social media profiles
Negative Penalty	-3	Keyword stuffing, no author signal

Trust Stack (grade C, medium):

• Technical: 3/5 (missing CSP, X-Frame-Options headers)
• Identity: 3/5 (missing about page link, author attribution)
• Social: 4/5 (6 sameAs, KG pillars 2/4, reviews present)
• Academic: 1/5 (no statistics, no numbers, no references section)
• Consistency: 4/5 (brand consistent, dateModified present)

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

Category	Score	Notes
Robots	15	✅ AI bots permitted
llms.txt	14	✅ llms.txt present
Schema JSON-LD	0	No Organization, WebSite, or FAQPage schema
Meta Tags	11	Missing canonical tag
Content	12	478 numbers cited, keyword stuffing (issue 22.8%)
Signals	3	12 broken links, popup signals detected
AI Discovery	0	No ai.txt, no /ai/ endpoints
Brand & Entity	3	No sameAs links in schema
Negative Penalty	-3	Keyword stuffing, broken links, popup signals

Trust Stack (grade C, medium):

• Technical: 5/5 ✅ (HTTPS, HSTS, CSP, X-Frame-Options)
• Identity: 3/5 (no contact in schema, no Organization JSON-LD)
• Social: 1/5 (no sameAs links, no KG pillars, no social media links)
• Academic: 4/5 (478 numbers, 4 statistics, references section)
• Consistency: 3/5 (no dateModified, schema ≠ meta description)

📄 Sitemap Page Scores (20 pages audited)

Top Pages

URL	Score	Band
/ (homepage)	42	Foundation
/blog/2	33	Critical
/blog/3	33	Critical
/blog/7	33	Critical
/blog/2026-01-13-meet-the-workflows-continuous-improvement	33	Critical

Worst Pages

URL	Score	Band
/agent-factory-status	27	Critical
/blog/2026-01-13-meet-the-workflows-interactive-chatops	30	Critical
/blog/2026-01-13-meet-the-workflows-documentation	30	Critical
/blog/2026-01-13-meet-the-workflows-creative-culture	30	Critical
/blog/2026-01-13-meet-the-workflows-continuous-style	30	Critical

Average score breakdown across 20 pages:

• Robots: 0.0 | llms.txt: 0.0 | Schema: 0.6 | Meta: 14.0
• Content: 10.6 | Signals: 5.05 | AI Discovery: 0.0 | Brand/Entity: 2.25
• Negative penalty: -1.0

The robots/llms/AI discovery zeros are site-wide issues fixable with a few config files. Adding robots.txt + llms.txt + ai.txt alone would raise the average from 31.5 to ~61 across all pages.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · sonnet46 993.7K · ◷

• expires on Jun 1, 2026, 5:38 PM UTC

[github-actions[bot]]

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

A newer discussion is available at Discussion #36298.