Agent Contract · llms-txt
Without it, an assistant deciding what your site is about crawls whatever it happens to find. llms.txt is the cheapest way to control that first impression, and today most of your competitors do not have one either.
| Check id | llms-txt |
|---|---|
| Pillar | Agent Contract — Have you told agents the rules: what they may use, where the docs are, who to contact? |
| Weight within the pillar | 14 points |
| Share of the overall score | about 3.8 of 100 |
| Kind of change | Configuration or content — no engineering needed |
Two numbers rather than one, because a check's weight is inside its pillar and the pillar is a share of the whole. The largest check in the smallest pillar moves your score less than a middling one in the largest, and knowing which you are looking at is the difference between fixing the right thing and fixing the loudest thing.
Without it, an assistant deciding what your site is about crawls whatever it happens to find. llms.txt is the cheapest way to control that first impression, and today most of your competitors do not have one either.
Worth saying plainly: this is not a search-engine ranking factor and passing it will not move you up a results page. It measures something else — whether software with no browser, no JavaScript and a few hundred tokens of budget can tell what your page is and do something with it. Those are the conditions an AI assistant reads you under, and they are much harsher than a browser's.
Publish an llms.txt: a title, one paragraph, then curated links grouped by intent.
/llms.txt
# Example Inc
> One paragraph an assistant can quote verbatim about what you do and who it is for.
## Docs
- [Quickstart](https://example.com/docs/quickstart): Get running in five minutes.
- [API reference](https://example.com/docs/api): Every endpoint with examples.
## Product
- [Pricing](https://example.com/pricing): Plans, limits and exact prices.
- [Changelog](https://example.com/changelog): What shipped, newest first.
## Policies
- [Terms](https://example.com/terms)
- [Contact](https://example.com/contact): support@example.comThat remediation is the one the scanner itself offers when this check fails, read from the same code that does the scoring rather than written alongside it. If it were typed out separately it could drift from the check that judges it, which is the failure that makes published advice worthless.
Measured on 2026-09-06 against AX specification v1.5.1, across a sample of 292 public websites.
| Result | Sites | Share of those assessed |
|---|---|---|
| Failed | 228 | 78% |
| Warned | 0 | 0% |
| Passed | 64 | 22% |
| Did not apply | 0 | excluded from the shares |
The last row is kept out of the percentages deliberately. A check that did not apply to 0 of 292 sites is not a check most of the web passes, and folding those in is the commonest way this sort of table is used to say something untrue.
At 78% this is one of the things nearly everybody gets wrong, which cuts both ways: you are not unusual for failing it, and fixing it separates you from most of your competitors rather than catching you up with them.
npx axray-cli your-site.com
All 70 checks against one URL, this one among them, with what was found rather than only whether it
passed. Add --min 70 in a pipeline and the command exits non-zero below that score, so a
change that breaks what agents can read fails the build instead of shipping.
Without it, an assistant deciding what your site is about crawls whatever it happens to find. llms.txt is the cheapest way to control that first impression, and today most of your competitors do not have one either. It sits in the Agent Contract pillar of the Agent Experience rubric and is worth 14 points within that pillar, which works out at about 3.8 points of the overall score out of 100.
Publish an llms.txt: a title, one paragraph, then curated links grouped by intent. /llms.txt It is a configuration or content change rather than an engineering one, so it can usually ship the same day.
No. Of 292 public sites where this check applied, 228 failed it — 78%. The measurement was taken on 2026-09-06 against AX specification v1.5.1, and no site is named.
Run npx axray-cli your-site.com from a terminal. It runs all 70 checks against one URL and prints this one among them, with what it found rather than only whether it passed. It is free, needs no account and installs nothing.
Have you told agents the rules: what they may use, where the docs are, who to contact?
See how your own page does on this check and the other 69, with the fixes ordered by how many points each one recovers. One scan, no account.