agents-md

Installation
SKILL.md

AGENTS.md Creation & Refactoring

Create minimal, focused AGENTS.md files that use progressive disclosure.

Core Principles

  1. Instruction budget: LLMs can follow ~150-200 instructions consistently. Every token loads on every request.
  2. Progressive disclosure: Give agents only what they need now, point elsewhere for specifics.
  3. Avoid staleness: Don't document file paths—they change. Document capabilities and domain concepts.

What Belongs in Root AGENTS.md

Only these essentials:

  • One-sentence project description (anchors agent decisions)
  • Package manager (if not npm)
  • Non-standard build/typecheck commands

Everything else goes elsewhere.

Related skills
Installs
10
GitHub Stars
1
First Seen
Jan 24, 2026