[geo-optimizer] GEO Audit Report — 2026-07-03

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-03
Run: §28673522290

---

📊 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 of 195 pages)	36/100	Foundation / Critical

---

✅ Top Strengths

• Meta tags (docs site): 14/14 — Title, description, canonical, Open Graph, and no noai blocking are all perfectly set
• Signals (docs site): 6/6 — Language tag, RSS feed, and freshness date all present
• robots.txt (github.com): 15/18 — 27 AI bots explicitly allowed, including GPTBot, ClaudeBot, PerplexityBot, Google-Extended
• llms.txt (github.com): 14/18 — Well-structured with 2,919 words, 12 sections, 117 links, and blockquote
• Schema JSON-LD (docs site): 12/16 — WebSite, Organization, SoftwareApplication, and FAQPage types all present
• Content (README): 12/12 — Rich content with 2,931 words, numbers/statistics, heading hierarchy, lists, and front-loaded key info

---

🚨 Critical Gaps

1. No robots.txt on docs site (0/18) — The docs site at github.github.com/gh-aw/ has no robots.txt. AI crawlers operate in an ambiguous permission state. This single gap costs 18 points and affects all 195 discovered sitemap pages.
2. No llms.txt on docs site (0/18) — LLMs can't discover a structured site summary for github.github.com/gh-aw/. This is the second-largest gap (18 pts) and affects the entire site.
3. No AI discovery endpoints anywhere (0/6 on both) — Neither /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, nor /ai/service.json exist on either target.
4. No Schema JSON-LD on README (0/16) — The GitHub repo page has zero structured data markup (no WebSite, no Organization, no FAQPage schema).
5. Sitemap pages mostly "Critical" band — 11 of 20 audited pages score below 35. Blog pagination pages (/blog/3–/blog/10) score 30–33 with no schema at all.

---

🔧 Recommended Fixes

Ordered by estimated score impact:

1. Create robots.txt for docs site (+18 pts, all pages affected)
   Run: geo robots --base-url https://github.github.com/gh-aw/ and host the output at https://github.github.com/gh-aw/robots.txt. Explicitly allow GPTBot, ClaudeBot, PerplexityBot, Google-Extended.

2. Create /llms.txt for docs site (+18 pts, all pages)
   Run: geo llms --base-url https://github.github.com/gh-aw/ to generate a structured LLM index. Host at https://github.github.com/gh-aw/llms.txt.

3. Add AI discovery endpoints to docs site (+6 pts)
   Create /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json. See spec for schema.

4. Add Schema JSON-LD to README / GitHub repo page (+16 pts on README)
   Add WebSite, Organization (with sameAs to Wikipedia/Wikidata), and FAQPage JSON-LD. This brings the README score from Foundation toward Good.

5. Add WebApp schema to docs site (+4 pts)
   Currently missing from docs site schema. Add SoftwareApplication/WebApplication type with applicationCategory, operatingSystem, and offers.

6. Sync schema description with meta description on docs site
   schema_desc_matches_meta is false — align them to fix the brand-consistency penalty.

7. Add numerical statistics to docs site content (±40% AI visibility per audit)
   The docs homepage has 0 numbers. Add concrete data points (e.g., supported workflow count, time savings, bot coverage).

📋 Full Breakdown by Category — Docs Site

Category	Score	Max	Notes
robots.txt	0	18	Not found — all AI bots in ambiguous state
llms.txt	0	18	Not found
Schema JSON-LD	12	16	WebSite, Organization, SoftwareApplication, FAQPage present; missing WebApp
Meta Tags	14	14	✅ Perfect
Content	7	12	No numbers/stats; no front-loading; no lists/tables
Signals	6	6	✅ Perfect — lang, RSS, freshness
AI Discovery	0	6	No /.well-known/ai.txt, no /ai/*.json
Brand & Entity	7	10	KG pillars present (4/4); no about page link; no recent articles
Negative Penalty	-3	—	Hidden text (keyboard shortcut "CtrlK"), keyword stuffing ('github' at 2.8%)

Platform Citation Scores:

• ChatGPT: 50/100
• Perplexity: 65/100
• Google AI: 80/100

Trust Stack: Grade C (15/25) — Technical: 3/5, Identity: 3/5, Social: 4/5, Academic: 1/5, Consistency: 4/5

Negative signals: Hidden text (display:none), keyword stuffing ('github' 2.8%), video without VideoObject schema

📋 Full Breakdown by Category — README

Category	Score	Max	Notes
robots.txt	15	18	27 AI bots explicitly allowed on github.com
llms.txt	14	18	2,919 words, 12 sections, 117 links; no llms-full.txt
Schema JSON-LD	0	16	None — no WebSite, Organization, or FAQPage schema
Meta Tags	11	14	No canonical URL; weak description (98 chars)
Content	12	12	✅ Perfect
Signals	3	6	No RSS, no freshness date in schema
AI Discovery	0	6	No /.well-known/ai.txt, no /ai/*.json
Brand & Entity	3	10	No KG pillar links, no Wikipedia/Wikidata, no contact info in schema
Negative Penalty	-3	—	Hidden text, keyword stuffing ('issue' at 22.5%), popup signals, 13 broken links

Platform Citation Scores:

• ChatGPT: 55/100
• Perplexity: 70/100
• Google AI: 48/100

Trust Stack: Grade C (16/25) — Technical: 5/5, Identity: 3/5, Social: 1/5, Academic: 4/5, Consistency: 3/5

Content Decay Risk: High — version strings ("v0.81.6"), release counts ("398"), and recency language without dateModified schema

📄 Sitemap Page Scores (top 5 and bottom 5 of 20 audited)

Top pages:

URL	Score	Band
/blog/2026-01-13-meet-the-workflows-continuous-improvement	44	Foundation
/ (home)	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:

URL	Score	Band
/blog/10	30	Critical
/blog/8	31	Critical
/blog/6, /blog/7, /blog/3	32	Critical

All pages score 0/18 on robots.txt, 0/18 on llms.txt, and 0/6 on AI discovery — these three gaps are consistent across the entire site.

⚠️ Only 20 of 195 discovered URLs were audited. The full site likely has many more Critical-band pages.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 38.2 AIC · ⌖ 13.5 AIC · ⊞ 5K · ◷

• expires on Jul 6, 2026, 8:57 AM UTC-08:00

[github-actions[bot]]

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

A newer discussion is available at Discussion #43417.