AGENTS.md Skill

Overview

Creates and refactors AGENTS.md files following progressive disclosure principles. Keeps files minimal and focused—avoiding the "ball of mud" that hurts agent performance.

When to Use

• Proactively when a project has no AGENTS.md at the root — check for this when starting work in a new project
• Creating a new AGENTS.md from scratch
• Refactoring a bloated AGENTS.md
• Reviewing an existing file for best practices
• Setting up AGENTS.md for a monorepo
• When AGENTS.md exists but CLAUDE.md is missing (should be symlinked)

Core Principles