---
title: "Serving one file too large for any agent · Agent Wranglers"
url: https://agentwranglers.se/playbook/website/ready-for-ai-agents/oversized-agent-file
id: WEB-257
level: Avoid
updated: 2026-10-22
tokens: 564
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Serving one file too large for any agent to read

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Ready for AI agents](https://agentwranglers.se/playbook/website/ready-for-ai-agents.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-22.

- ID: WEB-257
- Level: Avoid
- Chapter: [Ready for AI agents](https://agentwranglers.se/playbook/website/ready-for-ai-agents.md)
- Rule: Never publish a file for agents to read that is larger than an agent's context window. A full-site dump of millions of tokens is one example.
- Check: No file linked from llms.txt, a skill or an agent card passes that limit, apart from JSON labelled for tools.
- How: An agent cannot read such a file, so it fetches it, truncates it and guesses. Building it on request can also stall the server. On a reference site, a 6 MB full-content file built on each request stalled the server under a burst of agent requests. Offer an outline, section files and search instead. Keep each file under the limit in [Offer one file only while it fits an agent's context](https://agentwranglers.se/playbook/website/ready-for-ai-agents/llms-full-txt.md). JSON meant for tools, not for reading, may be larger when it is labelled that way.

## Related rules

- WEB-185 [Offer one file only while it fits an agent's context](https://agentwranglers.se/playbook/website/ready-for-ai-agents/llms-full-txt.md) in Website

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/website/ready-for-ai-agents/oversized-agent-file">Agent Wranglers website playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Offer one file only while it fits an agent's context](https://agentwranglers.se/playbook/website/ready-for-ai-agents/llms-full-txt.md)
- Next: [State the size of every agent file in tokens](https://agentwranglers.se/playbook/website/ready-for-ai-agents/token-counts.md)
- [Ready for AI agents](https://agentwranglers.se/playbook/website/ready-for-ai-agents.md)