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

alexastrum Hiding risky files

alexastrumAGENTS.md

skl

alexastrum/skl/AGENTS.md

skl supports 40+ agent environments. It evaluates the local filesystem and environment variables to detect installed agents, routing and linking skills dynamically. We enforce strict feature parity (commands, flags, platforms) with the original TypeScript skills npm package. Antigravity maps to ~/.gemini/config (original IDE) and ~/.gemini/antigravity (2.0). IMPORTANT: ONLY WHEN EDITING README.md or human docs (eg --help) run /humanizer skill. skl detects agents via project folders (e.g., .cursor, .cline, .zed) or environment variables (XDGCONFIGHOME, APPDATA, etc.): Skills are mapped using relative…

115mo agoReviewMount

alexastrumAGENTS.md

skl / humanizer

alexastrum/skl/.agents/skills/humanizer/AGENTS.md

Guidance for AI coding agents (Claude Code, Codex, Warp, etc.) working in this repository. A Claude Code / OpenCode skill implemented entirely as Markdown. The runtime artifact is SKILL.md: the agent reads its YAML frontmatter (metadata + allowed tools) followed by the editor prompt. There is no build step and no code to run. SKILL.md and README.md must stay in sync. When you change behavior or content:

115mo 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.