Skip to content
  1. Home
  2. Guides and documents
  3. AGENTS.md

AGENTS.md

Open format for a file that tells coding agents how to work in a repo

What it is

The repository behind the AGENTS.md format: a README-style Markdown file in a project that gives coding agents setup commands, test instructions and conventions. It holds a minimal example and the source of the agents.md website. For maintainers who want one instruction file read by many agents.

Good for

  • Write a first AGENTS.md for a project
  • Document test and lint commands for agents
  • Share one instruction file across tools
Worth knowingA convention rather than a tool, and the repo is short; some agents read their own file name unless configured.

Sources

The summary is ours, written from the README. Spotted an error? See how we work.

More for coding

See the topic →
  • Karpathy-Inspired Claude Code Guidelines

    multica-ai/andrej-karpathy-skills

    One CLAUDE.md with four rules against common LLM coding mistakes

    GuideGitHub stars: 233k
  • OpenAI Cookbook

    openai/openai-cookbook

    Official examples and guides for common OpenAI API tasks

    GuideGitHub stars: 77k
  • Awesome Claude Code

    hesreallyhim/awesome-claude-code

    Curated list of Claude Code skills, agents, tooling and plugins

    GuideGitHub stars: 58k
  • Claude Cookbooks

    anthropics/claude-cookbooks

    Anthropic's notebooks and recipes for building with Claude

    GuideGitHub stars: 55k