AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

appeeky Hiding risky files

appeekyAGENTS.md

aso-skills

appeeky/aso-skills/AGENTS.md

This repo contains ASO & App Marketing skills following the Agent Skills open standard. Compatible directories: .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/ Description drives discovery — agent reads all descriptions to decide which skill to load. Include "When the user wants to...", trigger keywords, and "For X, see Y skill" boundaries. iOS limits: Title 30 chars, Subtitle 30 chars, Keyword field 100 chars (comma-separated, no spaces), Description 4000 chars (not indexed for search), Promotional text 170 chars. Google Play limits: Title 30…

1 project uses a version of this

2.2k8mo agoReviewMount

appeekyAGENTS.md

ua-skills

appeeky/ua-skills/AGENTS.md

This repo (appeeky/ua-skills) contains mobile app user acquisition skills — ads, creatives, and ROAS — following the Agent Skills open standard. Compatible directories: .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/ Description drives discovery…

532mo agoReviewMount

CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.