HOW TO WRITE A GREAT AGENTS.MD: LESSONS FROM OVER 2,500 REPOSITORIES

Summary from the TLDR Dev newsletter

GitHub analyzed 2,500+ `agents.md` files and found the successful ones were specialists with clear jobs, not vague helpers. Good agents.md files give your agent specific commands to run, concrete code examples to follow, and explicit boundaries (like “never touch these files”). Start simple with one focused task like writing tests or docs, then iterate based on what breaks.