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

[github-actions[bot]]

GEO Audit Report — github/gh-aw

Audit Date: 2026-07-04
Run: §28712769893
Tool: geo-optimizer-skill

---

📊 Scores

Target	Score	Band	Trend
Docs site (github.github.com/gh-aw/)	43/100	Foundation	—
README (github.com/github/gh-aw)	55/100	Foundation	—
Sitemap avg (20/195 pages audited)	36.45/100	Foundation/Critical	11 Critical, 9 Foundation

Score bands: Critical < 40 · Foundation 40–59 · Good 60–79 · Excellent 80+

---

✅ Top Strengths

1. Docs site: Perfect meta tags (14/14) — title, description, canonical, and all Open Graph tags are present and well-formed.
2. Docs site: Full signals score (6/6) — language declaration, RSS feed, and freshness date all present.
3. Docs site: Strong schema types — WebSite, Organization, SoftwareApplication, and FAQPage JSON-LD schemas all detected.
4. Docs site: Knowledge Graph pillars (4/4) — sameAs links to Wikipedia, Wikidata, LinkedIn, and Crunchbase all in place.
5. README: AI bot permissions declared — GPTBot, PerplexityBot, and Google-Extended are explicitly allowed in robots.txt (15/18 robots score). llms.txt is also present with links (14/18).

---

🚨 Critical Gaps

1. Docs site has NO robots.txt (0/18) — AI crawlers (GPTBot, ClaudeBot, PerplexityBot) are not permitted or guided. This affects every page in the sitemap; all 20 audited pages score 0/18 on robots.
2. Docs site has NO llms.txt (0/18) — No LLM-friendly site summary exists. Paired with the missing robots.txt, the docs site loses 36 of a possible 36 points just from these two files.
3. AI Discovery endpoints missing on both targets (0/6 each) — /.well-known/ai.txt, /ai/summary.json, /ai/faq.json, and /ai/service.json are absent from the docs site. These structured machine-readable endpoints are checked by emerging AI discovery protocols.
4. README has NO JSON-LD schema (0/16) — No structured data on the GitHub repository homepage. The docs site has good schema (12/16) but the README has none.
5. 13 broken links in README — Detected as a negative signal (severity: medium), reducing trust and penalising the negative-signals score (−3 penalty applied).

---

🔧 Recommended Fixes

Ordered by estimated score impact:

Priority	Fix	Target	Est. Impact
🔴 1	Add robots.txt to docs site allowing AI bots	Docs site + all sitemap pages	+18 pts each page
🔴 2	Add /llms.txt to docs site	Docs site + all sitemap pages	+18 pts each page
🟠 3	Add AI discovery endpoints (/.well-known/ai.txt, /ai/summary.json, /ai/faq.json, /ai/service.json)	Both targets	+6 pts each
🟠 4	Add JSON-LD schema to README (WebSite + Organization + FAQPage)	README	+16 pts
🟡 5	Fix 13 broken links in README	README	removes −3 penalty
🟡 6	Remove hidden text (CtrlK element with display:none) from docs site	Docs site	removes prompt-injection flag
🟢 7	Add numerical stats/data to docs site content (currently 0 numbers found)	Docs site content	partial content score
🟢 8	Add VideoObject JSON-LD schema for the 2 detected videos on docs site	Docs site	schema score improvement

---

📋 Full Category Breakdown

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

Category	Score	Max	Notes
Robots.txt	15	18	GPTBot, PerplexityBot, Google-Extended allowed
llms.txt	14	18	Present with links; missing blockquote/optional sections
Schema JSON-LD	0	16	None detected
Meta Tags	11	14	Partial — some tags incomplete
Content	12	12	✅ Full score
Signals	3	6	Partial
AI Discovery	0	6	No endpoints
Brand & Entity	3	10	Weak — no KG pillars on GitHub.com domain
Negative penalty	−3	—	Broken links (13), keyword stuffing

Platform citation: ChatGPT 55 · Perplexity 70 · Google AI 48
Trust grade: C (medium) — Academic trust very low (1/5): no stats, no numbers in content
RAG chunk readiness: 46/100 — avg section only 23.6 words, no definition-style opening
Context efficiency: 42/100 — key info tokens only 312 of 1,918 total

---

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

Category	Score	Max	Notes
Robots.txt	0	18	No robots.txt found
llms.txt	0	18	No llms.txt found
Schema JSON-LD	12	16	WebSite, Organization, SoftwareApplication, FAQPage present; missing sameAs on schema
Meta Tags	14	14	✅ Perfect score
Content	7	12	H1 + headings + links present; no numbers/stats, no front-loading
Signals	6	6	✅ Perfect score
AI Discovery	0	6	No endpoints
Brand & Entity	7	10	Good KG pillars; schema desc ≠ meta desc
Negative penalty	−3	—	Hidden text (CtrlK element), keyword stuffing ('github' at 2.7%)

Platform citation: ChatGPT 50 · Perplexity 65 · Google AI 80
Trust grade: C (medium) — Social trust 4/5 (strong KG); Technical trust 3/5 (missing CSP, X-Frame-Options)
RAG chunk readiness: 45/100 — sections too short (avg 7.9 words), high heading-boundary ratio
Context efficiency: 65/100 — front-loaded ratio 38%, low truncation risk
Prompt injection risk: Medium — 1 hidden text pattern found (CtrlK)
WebMCP readiness: Basic — SearchAction detected but no tool attributes or labeled forms

📄 Sitemap Page Scores (20 of 195 URLs audited)

Score	Band	URL
44	Foundation	.../blog/2026-01-13-meet-the-workflows-continuous-improvement
43	Foundation	.../ (homepage)
43	Foundation	.../blog/2026-01-13-meet-the-workflows-continuous-refactoring
41	Foundation	.../blog/2026-01-12-welcome-to-pelis-agent-factory
41	Foundation	.../blog/2026-01-13-meet-the-workflows-advanced-analytics
41	Foundation	.../blog/2026-01-13-meet-the-workflows-campaigns
41	Foundation	.../blog/2026-01-13-meet-the-workflows-continuous-simplicity
41	Foundation	.../blog/2026-01-13-meet-the-workflows-continuous-style
37	Foundation	.../agent-factory-status
35	Critical	.../about
33	Critical	.../blog
33	Critical	.../blog/2
33	Critical	.../blog/4
33	Critical	.../blog/5
33	Critical	.../blog/9
32	Critical	.../blog/3
32	Critical	.../blog/6
32	Critical	.../blog/7
31	Critical	.../blog/8
30	Critical	.../blog/10

Note: 195 total URLs discovered; only 20 audited (cap hit). All pages score 0/18 for robots and 0/18 for llms — adding these two files would raise every page's score by up to 36 points.

---

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

Generated by 🌍 GEO Optimizer Daily Audit · 40.9 AIC · ⌖ 14.1 AIC · ⊞ 5K · ◷

• expires on Jul 7, 2026, 8:48 AM UTC-08:00