agents-md-setuplisted

Set up a project's agent instructions as a single source of truth — AGENTS.md as the real file, with CLAUDE.md (and optionally other agents' files) as symlinks to it. Use when starting/bootstrapping a repo, when asked to "add a CLAUDE.md / AGENTS.md", "set up project conventions / agent instructions", "make Claude use AGENTS.md", or when a repo has a standalone CLAUDE.md that should become cross-tool. Also use to fix duplicated/drifting CLAUDE.md + AGENTS.md, or to add per-workspace instructions in a monorepo (Turborepo / pnpm workspaces).
stealth-engine/skills · ★ 2 · AI & Automation · score 76

Install: claude install-skill stealth-engine/skills

# agents-md-setup Make **`AGENTS.md` the single source of truth** for agent/project instructions, and point every tool's file at it via **symlink**. One file, read by all agents — no duplication, no drift. ## Why this layout - `AGENTS.md` is the emerging cross-tool standard (Cursor, Codex, and others read it). - Claude Code reads `CLAUDE.md`. You **cannot** make the harness read `AGENTS.md` instead via a prompt or a skill — but a **symlink** `CLAUDE.md → AGENTS.md` means Claude opens `CLAUDE.md` and gets `AGENTS.md`'s content. That *is* the mechanism; nothing else is needed. *(True as of 2026-07: native `AGENTS.md` support is still an open request — [anthropics/claude-code#34235](https://github.com/anthropics/claude-code/issues/34235). Re-verify against the [changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) before relying on it; if Claude Code gains native `AGENTS.md` support the symlink becomes optional.)* - Result: edit `AGENTS.md` only; every agent stays in sync. ## Decision: what's already there? 1. **Neither file** → create `AGENTS.md` from the template below. 2. **Only `CLAUDE.md` (a real file)** → make it the source of truth: ```bash git mv CLAUDE.md AGENTS.md # preserve history (or: mv if not tracked) ``` 3. **Only `AGENTS.md`** → keep it as-is (good). 4. **Both exist as real files** → do NOT blindly overwrite. Compare them; merge into `AGENTS.md` (it wins as the canonical file), confirm with the user i