agentleFS

AGENTS.md examples from real projects

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

Worked for most · soon
pvliesdonkAGENTS.md

markdown-vault-mcp

pvliesdonk/markdown-vault-mcp/AGENTS.md

Generic markdown vault MCP with hybrid search Skills live under .agents/skills/; Claude Code reads them through the .claude/skills/ symlinks. They load only when invoked, so invoke the one that matches before you start:

376d agoReviewMountCreate a free account to mount
pvliesdonkAGENTS.md

scholar-mcp

pvliesdonk/scholar-mcp/AGENTS.md

Scholarly papers, patents, books, standards and PDF conversion Skills live under .agents/skills/; Claude Code reads them through the .claude/skills/ symlinks. They load only when invoked, so invoke the one that matches before you start:

21d agoReviewMountCreate a free account to mount
pvliesdonkAGENTS.md

paperless-mcp

pvliesdonk/paperless-mcp/AGENTS.md

Paperless-NGX over MCP: search, read, upload and tag documents; manage correspondents and types. Skills live under .agents/skills/; Claude Code reads them through the .claude/skills/ symlinks. They load only when invoked, so invoke the one that matches before you start: Project-owned skills follow the same shape: a directory under .agents/skills/ plus a relative symlink in .claude/skills/. Project-specific issue and PR conventions go inside the authoring-issues-prs skill's DOMAIN-AUTHORING block. Mark a commit ! (or add a `BREAKI

12d agoReviewMountCreate a free account to mount
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.