AGENTS.md

When to write an agent skill

Vercel ran an eval where installed skills scored exactly the same as no documentation at all, because the agent never opened them in 56% of cases. A flat docs index in AGENTS.md scored 100% on the same suite. The useful reading of that result is about which of two jobs you're doing: putting a fact in front of the model, or getting a sequence carried out the same way every time.