URL: /rules/ax/llms-txt

---
title: "llms.txt"
description: "Detects /llms.txt (and /llms-full.txt) at the domain root and checks its basic Markdown format"
---

Detects a [`llms.txt`](https://llmstxt.org) file at your domain root (and the optional `llms-full.txt` companion) and checks its basic Markdown shape. `llms.txt` is an emerging standard that gives AI agents and answer engines a curated, machine-readable map of your most useful content — a discoverability signal alongside `robots.txt` and `sitemap.xml`.

| | |
|---|---|
| **Rule ID** | `ax/llms-txt` |
| **Category** | [Agent Experience](/rules/ax) |
| **Scope** | Site-wide |
| **Severity** | info |
| **Weight** | 1/10 |

<Note>This rule is a **recommendation** — it never penalizes your score. `llms.txt` is optional; the rule just surfaces whether it exists and whether its format looks valid.</Note>

## What it checks

The audit fetches `/llms.txt` and `/llms-full.txt` from your domain root **once per crawl** (next to `robots.txt`), so the check itself does no extra network requests. It then reports:

- **Presence** — whether `/llms.txt` exists, its size, and whether the optional `/llms-full.txt` is also present.
- **Format** — basic [llmstxt.org](https://llmstxt.org) conformance of `/llms.txt`:
  - starts with an H1 title (`# Name`),
  - contains at least one Markdown link,
  - every link URL is well-formed (absolute or root-relative).

Format problems are reported as informational notes — they never fail the audit.

## Solution

Add a concise `/llms.txt` at your domain root. The format is plain Markdown: an H1 title, an optional blockquote summary, then sections of links to your key pages.

```markdown llms.txt
# Example Co

> Short summary of what this site is and who it's for.

## Docs

- [Getting started](https://example.com/docs/start): install and first run
- [API reference](https://example.com/docs/api): endpoints and types

## About

- [Pricing](https://example.com/pricing): plans and limits
```

Optionally add `/llms-full.txt` with the full text of those pages inlined, for agents that want everything in one fetch.

## Enable / Disable

### Disable this rule

```toml squirrel.toml
[rules]
disable = ["ax/llms-txt"]
```

### Disable all Agent Experience rules

```toml squirrel.toml
[rules]
disable = ["ax/*"]
```

### Enable only this rule

```toml squirrel.toml
[rules]
enable = ["ax/llms-txt"]
disable = ["*"]
```
