agents-md
One file to make all coding agents perform like senior engineers
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: agents-md. It is used for: One file to make all coding agents perform like senior engineers Full Skill content: https://321skill.com/skills/agents-md-ferroxlabs/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses issues of inconsistent behavior, rule violations, and excessive code modifications by AI coding agents. In real-world development, team members use various AI agents (e.g., Claude Code, Codex, Cursor, Gemini CLI), each with vastly different default behaviors. This often leads to unnecessary code refactoring, disregard for existing conventions, and verbose outputs, resulting in skyrocketing code review costs.
Usage is straightforward: simply run the installation command in your project root, place AGENTS.md in the project, and create symbolic links for Claude Code and Gemini CLI. Afterwards, all supported AI agents will automatically read this file and operate according to the "senior engineer" code of conduct: rejecting unreasonable requests, outputting minimal diffs, writing tests before reporting, and proactively clarifying ambiguities. You only need to fill in the project context (build commands, directory layout, etc.) once in Section 10. Section 11 will be automatically populated by agents to record each correction, creating a continuous learning loop for improvement.
It's ideal for development teams or individuals needing to standardize AI collaboration norms. This is especially true for teams already using multiple AI coding agents who want to reduce code review burden and improve code quality. Project managers and full-stack developers can use this file to quickly align all agents with team coding standards, avoiding rework caused by agent behavior discrepancies.
We recommend adopting this file uniformly during project initialization and ensuring all team members use the same version of AGENTS.md. Note that it primarily relies on the AGENTS.md file in the project root; large multi-module projects may require a copy in each submodule. Also, Section 10 requires manual input and cannot automatically infer implicit rules from comments.
Key Features
Unlike manually writing CLAUDE.md or GEMINI.md, it adapts to 8 agents—including Claude Code, Codex, Cursor, Gemini CLI, and Aider—simultaneously through a single file, eliminating the need for separate configurations. Moreover, it features a built-in "learning accumulation" mechanism (Section 11). When an agent makes a mistake, you correct it once, and the agent automatically writes the lesson into the file, benefiting all subsequent agents.
Limitations
Requires write permissions in the project root directory and depends on agent support for reading AGENTS.md/CLAUDE.md/GEMINI.md. Some agents (e.g., older versions) may not fully adhere to its rules. The project context in Section 10 must be filled in manually and cannot be fully inferred automatically.
FAQ
Will installing this file overwrite my existing CLAUDE.md?
No. During installation, if CLAUDE.md or GEMINI.md already exists and contains content, the script will not overwrite it. Instead, it will insert `@AGENTS.md` as the first line, preserving the original content.
How do I update AGENTS.md to the latest version?
Simply re-run the curl download command to overwrite the old file, then restart your AI agent sessions. Note that the contents of Sections 10 and 11 need to be manually backed up and merged.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/agents-md-ferroxlabs/raw/index.md to read the original Skill definition (Markdown format) for agents-md, and install it according to the instructions.
Raw Markdown URL for AI: /skills/agents-md-ferroxlabs/raw/index.md