[geo-optimizer] Create /llms.txt for the docs site

[github-actions]

GEO Improvement: Create /llms.txt for the docs site

Source audit: GEO Audit Report — 2026-08-09
Audit date: 2026-08-09
Run: https://github.com/github/gh-aw/actions/runs/31324049076

Finding

"Create /llms.txt for AI indexing: geo llms --base-url https://github.github.com/gh-aw. Note: llms.txt is an organizational signal, not a proven ranking factor. It helps structure content for AI systems."

This recommendation appeared for both the docs homepage and all 20 sitemap pages audited (average score 37.75/100, Foundation band). llms.txt scored 0/points in the docs-site breakdown, the same as robots.txt — together these are the two lowest-scoring, easiest-to-fix categories in the entire audit.

Why this matters

/llms.txt is the primary structured-discovery signal that AI engines (ChatGPT, Claude, Perplexity) use to understand a site's content map without crawling every page individually. Since this is currently completely absent, it is one of only two 0-point categories (along with robots.txt) on the docs site, and fixing it is a single, well-documented step with no risk of regressions elsewhere in the page.

Suggested fix

1. Generate the file using the geo CLI referenced in the audit: geo llms --base-url https://github.github.com/gh-aw.
2. Place the generated llms.txt at the docs site root (https://github.github.com/gh-aw/llms.txt), likely under the Docusaurus static/ directory in this repo's docs source.
3. Ensure the file lists key doc sections (Getting Started, CLI reference, workflow authoring, security) with concise one-line descriptions per the llms.txt spec ((llmstxt.org/redacted)
4. Re-run the GEO audit to confirm the llms score moves from 0 toward its max points.

Generated by 🌍 GEO Optimizer Daily Audit · auto · 17.8 AIC · ⌖ 3.87 AIC · ⊞ 7K · ◷

• expires on Aug 16, 2026, 8:37 AM UTC-08:00