Skip to content

[WIP] Create /llms.txt for the docs site - #51616

Closed
pelikhan with Copilot wants to merge 1 commit into
mainfrom
copilot/geo-optimizer-create-llms-txt
Closed

[WIP] Create /llms.txt for the docs site#51616
pelikhan with Copilot wants to merge 1 commit into
mainfrom
copilot/geo-optimizer-create-llms-txt

Conversation

Copilot AI commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.


This section details on the original issue you should resolve

<issue_title>[geo-optimizer] Create /llms.txt for the docs site</issue_title>
<issue_description>### 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

Comments on the Issue (you are @copilot in this section)

Copilot AI linked an issue Aug 9, 2026 that may be closed by this pull request
@pelikhan pelikhan closed this Aug 9, 2026
Copilot stopped work on behalf of pelikhan due to an error August 9, 2026 16:39
Copilot AI requested a review from pelikhan August 9, 2026 16:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

2 participants