Last week I published shimmer-trace , a React skeleton loader that traces your real DOM and paints a pixel-perfect shimmer over it. No manual skeletons. One-line wrap. Zero CLS.
But this post isn't about the shimmer. It's about a small file I shipped alongside it that I think is going to become a standard:
AGENTS.md — a README written for AI agents, not humans.
The Problem: Your README Is Lying to the LLM
In 2026, more than half the people "reading" your library docs aren't people. They're Cursor, Claude Code, Copilot, and a hundred other agents writing code on behalf of a developer.
And here's the thing — your README.md is built for humans. It has marketing copy. Animated GIFs. "Why we built this." Friendly tone.
When an LLM reads it, it has to guess:
What are the exact prop names?
Which combinations are valid?
What's the default value of speed ?
What goes wrong if I forget dummyData ?
So the agent hallucinates. It invents prop names. It mixes up patterns from three other skeleton libraries.…