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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-06-10
Run: §27293875094

---

📊 Scores

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

---

✅ Top Strengths

• Docs site meta tags: 14/14 — title, description, canonical URL, and all Open Graph tags present and well-formed.
• Docs site signals: 6/6 — lang attribute set, RSS feed present, freshness date detected (2026-05-09).
• Docs site Schema JSON-LD: 12/16 — WebSite, Organization, SoftwareApplication, and FAQPage types all found.
• README robots.txt: 15/18 — 27 AI crawlers explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.), none blocked.
• README llms.txt: 14/18 — present with 2,919 words across 12 sections and 117 links, well-structured with H1, description, and blockquote.
• README content: 12/12 — comprehensive (3,179 words), includes numbers/stats, lists, tables, and front-loaded with key information.

---

🚨 Critical Gaps

1. Docs site robots.txt completely missing (0/18) — AI crawlers have no explicit permission grant for github.github.com/gh-aw/. This alone costs 18 points.
2. Docs site llms.txt completely missing (0/18) — AI engines cannot discover a structured content summary for the documentation site.
3. AI Discovery endpoints absent on both sites (0/6 each) — No /.well-known/ai.json, no summary endpoint, no FAQ endpoint, no service endpoint declared.
4. README has no Schema JSON-LD (0/16) — GitHub.com does not inject structured data for repository pages; no workaround is in place.
5. Sitemap pages all in Critical band (27–42/100) — All 20 crawled pages (mostly blog pages) inherit the missing robots.txt/llms.txt penalty and score in the Critical tier.
6. Brand entity gaps: Docs site schema description doesn't match meta description; no Wikipedia article or Crunchbase profile; README has zero KG pillar URLs.

---

🔧 Recommended Fixes

Ordered by expected score impact:

1. Add robots.txt to github.github.com/gh-aw/ (+18 pts docs site, propagates to all sitemap pages)

   • Allow all AI citation bots explicitly: GPTBot, ClaudeBot, PerplexityBot, Google-Extended, anthropic-ai, cohere-ai, etc.
   • Mirror the comprehensive allow-list already in the GitHub.com robots.txt.

2. Add llms.txt to github.github.com/gh-aw/ (+18 pts docs site)

   • Follow the structure already present at github.com/github/gh-aw/llms.txt.
   • Include H1, a concise description, sections for key topics, and links to important pages.
   • Consider adding an llms-full.txt companion for deeper content.

3. Add /.well-known/ai.json (AI Discovery) to both sites (+6 pts each)

   • Declare a machine-readable summary, FAQ count, and service endpoints.
   • This unlocks the AI Discovery category entirely on both targets.

4. Add llms-full.txt to the GitHub repo (closes llms.txt gap 14→18)

   • The has_full flag is currently false; a full companion file would address the remaining gap.
   • Also add an optional section and companion files hint in llms.txt.

5. Fix README meta description (improves meta_tags 11→14)

   • Current description is only 98 characters and is GitHub boilerplate.
   • Replace with a project-specific description of 150–160 characters and ensure a canonical URL is present.

6. Fix docs site schema/meta description mismatch (improves brand_entity 6→10)

   • The JSON-LD description field does not match the <meta name="description"> tag; align them.
   • Add an About link, and link to Crunchbase once a profile exists.

7. Add quantitative content to the docs site homepage (content 7→12)

   • has_numbers, has_lists_or_tables, and has_front_loading are all false.
   • Add headline stats (e.g. number of workflows, stars, adopters), bullet lists, and move the key value prop above the fold.

8. Build brand entity KG pillars for the README (brand_entity 3→10)

   • Create a Wikidata entry specifically for gh-aw (currently only GitHub the company has entries).
   • Add a Crunchbase profile and ensure LinkedIn / Wikipedia links are present in the README.

9. Add RSS feed and freshness signals to the GitHub repo page (signals 3→6)

   • Link the docs site RSS (https://github.github.com/gh-aw/blog/rss.xml) from the README.
   • Add a Last updated badge or timestamp to provide a freshness signal.

📋 Full Breakdown by Category

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

Category	Score	Max	Status	Key Details
robots_txt	0	18	❌	File not found
llms_txt	0	18	❌	File not found
schema_jsonld	12	16	✅	WebSite, Organization, SoftwareApplication, FAQPage — missing WebApp type
meta_tags	14	14	✅	All tags present; description 186 chars, title 31 chars
content	7	12	✅	926 words, 23 headings — missing numbers, lists/tables, front-loading
signals	6	6	✅	lang=en, RSS feed, freshness date 2026-05-09
ai_discovery	0	6	❌	No /.well-known/ai.json, no summary/FAQ/service endpoints
brand_entity	6	10	✅	Brand consistent, LinkedIn + Wikidata KG pillars — schema/meta description mismatch, no Wikipedia/Crunchbase, no About link

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

Category	Score	Max	Status	Key Details
robots_txt	15	18	✅	27 AI bots allowed; citation_bots_explicit: false
llms_txt	14	18	✅	2,919 words, 12 sections, 117 links — no llms-full.txt, no optional section
schema_jsonld	0	16	❌	No JSON-LD types found (GitHub.com platform limitation)
meta_tags	11	14	✅	Missing canonical URL; description 98 chars (too short); title has platform noise
content	12	12	✅	3,179 words, 43 headings, front-loaded, 493 numbers, lists/tables
signals	3	6	✅	lang=en — no RSS feed, no freshness date
ai_discovery	0	6	❌	No /.well-known/ai.json, no summary/FAQ/service endpoints
brand_entity	3	10	✅	Brand consistent — zero KG pillar URLs, no Wikipedia/Wikidata/LinkedIn/Crunchbase links

📄 Sitemap Page Scores (top 10 of 20 audited)

Page	Score	Band
gh-aw/ (homepage)	42	Foundation
gh-aw/blog	33	Critical
gh-aw/blog/3	33	Critical
gh-aw/blog/4	33	Critical
gh-aw/blog/8	33	Critical
gh-aw/blog/2026-01-13-meet-the-workflows-continuous-improvement	33	Critical
gh-aw/blog/2	32	Critical
gh-aw/blog/5	32	Critical
gh-aw/blog/6	32	Critical
gh-aw/blog/2026-01-13-meet-the-workflows-continuous-refactoring	32	Critical

All 20 pages score in the Critical band (27–42). The homepage is the only page reaching Foundation. The primary shared bottleneck across every page is the missing robots.txt and llms.txt on the docs site domain — fixing those two files would lift every page score simultaneously.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · ⌖ 13.9 AIC · ⊞ 17.1K · ◷

• expires on Jun 13, 2026, 9:45 AM UTC-08:00

[github-actions[bot]]

This discussion was automatically closed because it expired on 2026-06-13T17:45:29.013Z.

Closed by Workflow