[geo-optimizer] GEO Audit Report — 2026-06-26

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-26
Run: §28252975106

---

📊 Scores

Target	Score	Band	Key Strengths
Docs site (github.github.com/gh-aw/)	43/100	Foundation	Meta tags 14/14, Schema 12/16, Signals 6/6
README (github.com/github/gh-aw)	55/100	Foundation	Robots 15/18, llms.txt 14/18, Content 12/12
Sitemap average (20 of 192 pages)	37/100	Foundation/Critical	Meta tags strong site-wide (avg 14/14)

---

✅ Top Strengths

1. README robots.txt is exemplary — 27 AI bots explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Bingbot, and more), scoring 15/18.
2. README llms.txt is comprehensive — 2,919 words, 12 sections, 117 links, with blockquotes, scoring 14/18.
3. README content is fully optimized — perfect 12/12: has numbers/statistics, heading hierarchy, lists/tables, and front-loaded key info.
4. Docs site meta tags are perfect — 14/14: title, description, canonical URL, OG tags all present and well-formed.
5. Docs site Schema JSON-LD is strong — 12/16: WebSite, Organization, SoftwareApplication, and FAQPage types all present.
6. Docs site freshness signals pass — lang, RSS feed, and a freshness date (2026-05-09) all detected.
7. AI bots are not blocked anywhere — CDN checks confirm GPTBot, ClaudeBot, and PerplexityBot receive full content (HTTP 200, no challenges).

---

🚨 Critical Gaps

1. Docs site has no robots.txt (0/18) — AI crawlers have no explicit permission signal. This is the single largest gap on the docs site.
2. Docs site has no llms.txt (0/18) — No structured AI content index. This single fix would add up to 18 points to every page on the site.
3. Both sites score 0/6 on AI Discovery — No /.well-known/ai.txt, no /ai/summary.json, /ai/faq.json, or /ai/service.json exist on either domain.
4. README missing Schema JSON-LD (0/16) — GitHub.com does not inject WebSite or Organization schema for project pages; this lowers the README score but is not directly addressable in this repo.
5. 13 broken links detected on README — Negative signal for AI crawlers; broken anchors/links reduce credibility.
6. Docs site homepage has zero numerical data — No statistics or concrete numbers on the homepage (has_numbers: false), missing an estimated +40% AI visibility boost.
7. Half of sitemap pages score in Critical band (30–33) — Blog pagination pages /blog/5–/blog/9 score 30–33 due to absent schema and weak brand/entity signals.

---

🔧 Recommended Fixes

Ordered by estimated impact:

Priority	Fix	Expected Gain	Command / Action
🔴 1	Add llms.txt to docs site	+18 pts/page (site-wide)	geo llms --base-url https://github.github.com/gh-aw
🔴 2	Add robots.txt to docs site with AI bot Allow rules	+18 pts/page (site-wide)	Allow: GPTBot, ClaudeBot, PerplexityBot, Bingbot, etc.
🟠 3	Create /.well-known/ai.txt on docs site	+6 pts/page	Define AI crawler permissions
🟠 4	Create /ai/summary.json, /ai/faq.json, /ai/service.json on docs site	+6 pts/page	Structured AI discovery endpoints
🟠 5	Add llms-full.txt companion file to README	+4 pts on README	Full content dump for AI indexers; has_full: false currently
🟡 6	Fix 13 broken links on README	Removes negative penalty	Audit with gh or a link checker; fix/remove dead anchors
🟡 7	Add concrete statistics/numbers to docs homepage	+~5 pts	e.g., "runs 150+ workflow types", adoption numbers, benchmark data
🟡 8	Add lists or tables to docs site homepage	+2–3 pts	has_lists_or_tables: false on homepage
🟡 9	Front-load key info on docs homepage	+2 pts	Move value proposition to first 30% of content
🟢 10	Add canonical <link> tag to README (github.com)	+3 pts on README	has_canonical: false; not directly controllable — consider docs redirect

---

📋 Full Breakdown by Category

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

Category	Score	Max	Notes
Robots.txt	0	18	❌ Not found
llms.txt	0	18	❌ Not found
Schema JSON-LD	12	16	✅ WebSite, Organization, SoftwareApplication, FAQPage — missing WebApplication type
Meta Tags	14	14	✅ Perfect — title, description, canonical, OG all present
Content	7	12	⚠️ No numerical data, no lists/tables, no front-loading
Signals	6	6	✅ Perfect — lang=en, RSS feed, freshness date
AI Discovery	0	6	❌ No well-known/ai.txt, no AI JSON endpoints
Brand & Entity	7	10	✅ Wikipedia, Wikidata, LinkedIn, Crunchbase linked; missing About page link, no geo schema
Negative Penalty	-3	—	⚠️ Hidden text detected; keyword stuffing: "github" at 2.8% density

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

Category	Score	Max	Notes
Robots.txt	15	18	✅ 27 AI bots allowed; citation_bots_explicit: false prevents perfect score
llms.txt	14	18	✅ Found — 2,919 words, 12 sections, 117 links; missing llms-full.txt and optional section
Schema JSON-LD	0	16	❌ GitHub.com injects no project-level schema
Meta Tags	11	14	⚠️ No canonical URL; description (98 chars) is short and generic
Content	12	12	✅ Perfect — numbers, heading hierarchy, lists/tables, front-loading all present
Signals	3	6	⚠️ lang=en only; no RSS feed, no freshness meta tag
AI Discovery	0	6	❌ No well-known/ai.txt, no AI JSON endpoints
Brand & Entity	3	10	⚠️ Brand name consistent, has About link; no KG pillar URLs in schema
Negative Penalty	-3	—	⚠️ Keyword stuffing: "issue" at 22.6%; popup signals; 13 broken links; hidden text

📄 Sitemap Page Scores (20 of 192 pages audited)

Summary: avg 37/100 · 10 Foundation · 10 Critical

Average score breakdown across all pages:

Category	Avg Score	Max
AI Discovery	0.0	6
Robots.txt	0.0	18
llms.txt	0.0	18
Schema JSON-LD	4.6	16
Meta Tags	14.0	14
Content	10.65	12
Signals	5.45	6
Brand & Entity	3.3	10
Negative Penalty	-1.0	—

Top 5 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 5 pages (blog pagination):

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

Blog pagination pages score low due to absent Schema JSON-LD (0/16) and minimal Brand & Entity signals (2–3/10). Adding llms.txt and robots.txt site-wide would alone lift every page by up to +36 points.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 25.6 AIC · ⌖ 16.7 AIC · ⊞ 4.6K · ◷

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

[github-actions[bot]]

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

Closed by Workflow