using-agentsmd
Installation
SKILL.md
using-agentsmd
Follow this skill before you create or modify any AGENTS.md. Claude Code uses CLAUDE.md with the same discipline; below, AGENTS.md means both unless noted.
Hard gate
- About to
create/edit/appendany root or nestedAGENTS.md→ load this skill first - Do not change
AGENTS.mdwithout a user prompt; edits require an explicit request or prior permission - When the user says "put this in AGENTS.md" → run placement judgment first (below); write only if they still want it there
- Executing other tasks under already-injected
AGENTS.md→ do not load this skill - No
AGENTS.mdin the repo → do not create one by default; add when there are stable, non-obvious conventions or the user asks
What it is
AGENTS.md is a repo-level, passively injected high-signal prompt snippet.
- Done well: fewer mistakes, faster defaults, less repeated human steering
- Not: human docs, an encyclopedia, a changelog, or a copy of Skills / Rules / README