Token budget
Token budget and context fit
In short: Keep the file under about 8,000 tokens (roughly 32,000 bytes): trim low-value links and move long reference text into linked pages.
What it checks
Whether the file fits an agent’s context budget, about 8,000 tokens.
Why it matters
An agent reads the whole file before choosing links. A file too large to fit gets truncated, and the truncated part may be what mattered.
When it applies
Always, for any llms.txt that exists.
An audit that doesn't apply, or that we couldn't verify, is removed from your score and its weight shared among the Curation Quality audits that do apply. It is never scored as a zero.
How it's scored
1.0 ≤ 8k tokens · scaled down past that (1 − (tokens − 8k) / 34k) · 0.3 > 25k. Tokens are estimated as the file’s UTF-8 bytes ÷ 4, so 8k tokens is about 32,000 bytes. Budget only: an ## Optional section doesn’t change the score.
How to fix
- Aim for under 8,000 tokens (roughly 6,000 words).
- Cut duplicated, low-value and archive links first (see C1).
- Move long reference material into linked pages instead of the file itself.
Frequently asked questions
How does LLMSRank count the tokens in my llms.txt?
Sources: LLMSRank — Token budget audit · Claude API docs — Token counting
What happens to the Token budget score past 8,000 tokens?
1 − (tokens − 8,000) ÷ 34,000, so 15,000 tokens scores about 0.79 and 25,000 scores 0.5. Above 25,000 tokens (about 100,000 bytes) it drops to a flat 0.3, however large the file.Sources: LLMSRank — Token budget audit
Does an Optional section still protect a large file?
## Optional split 0.85; rubric v2.0 scores the budget alone, because llms.txt v2 says “the file itself stays small enough to fit in context” and treats Optional only as a convention for skippable links. Trimming the file is the only fix.Sources: llmstxt.org — The /llms.txt file, v2 · LLMSRank — Token budget audit
Should detailed content go in llms.txt itself or behind its links?
Sources: llmstxt.org — The /llms.txt file, v2 · LLMSRank — Token budget audit
How large are real llms.txt files?
Sources: LLMSRank — Method · LLMSRank — Token budget audit