agents-md
This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.
npx skills add majiayu000/claude-skill-registry --skill agents-md-sickn33-antigravity-awesome --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Maintaining AGENTS.md AGENTS.md is the canonical agent-facing documentation. Keep it minimal—agents are capable and don't need hand-holding. Target under 60 lines; never exceed 100. Instruction-following quality degrades as document length increases. ## When to Use - The user asks to create, update, or audit `AGENTS.md` or `CLAUDE.md`. - The project needs concise, high-signal agent instructions derived from the actual toolchain and repo layout. - Existing agent documentation is too long, duplicated, or drifting away from real project conventions. ## File Setup 1. Create `AGENTS.md` at project root 2. Create symlink: `ln -s AGENTS.md CLAUDE.md` ## Before Writing Analyze the project to understand what belongs in the file: 1. **Package manager** — Check for lock files (`pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`, `uv.lock`, `poetry.lock`) 2. **Linter/formatter configs** — Look for `.eslintrc`, `biome.json`, `ruff.toml`, `.prettierrc`, etc. (don't duplicate these in AGENTS.md) 3. **CI/build commands** — Check `Makefile`, `package.json` scripts, CI configs for canonical commands 4. **Monorepo indicators** — Check for `pnpm-workspace.yaml`, `nx.json`, Cargo workspace, or subdire
- When to Use
- File Setup
- Before Writing
- Writing Rules
- Required Sections
- Package Manager
- File-Scoped Commands
- Commit Attribution
- Key Conventions
- Optional Sections
- Anti-Patterns
- Example Structure
- Limitations
What does the agents-md skill do?
This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agents-md-sickn33-antigravity-awesome --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.