agents-md

Create and verify minimal AGENTS.md files with progressive disclosure.

5|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/DimitriGilbert/ai-skills --skill agents-md-dimitrigilbert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/DimitriGilbert/ai-skills/tree/main/agents-md
Command: npx skills add https://github.com/DimitriGilbert/ai-skills --skill agents-md-dimitrigilbert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AGENTS.md files are a central, yet often bloated and poorly organized, source of guidance for AI coding agents. This skill helps you create, verify, and improve AGENTS.md files using progressive disclosure, ensuring minimal root documentation with domain-specific, linked guidance.

Core Features & Use Cases

  • Guides the creation of minimal root AGENTS.md with links to domain-specific guidelines.
  • Supports verification you can run checks to reduce bloat, contradictions, and stale info.
  • Helps refactor bloated AGENTS.md into a nested structure in monorepos, with per-package AGENTS.md files and linked docs.

Quick Start

Create a minimal root AGENTS.md that links to domain-specific progressive disclosure files and nested package guides.

Frequently Asked Questions about agents-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize AGENTS.md files in a monorepo to avoid bloat?

Organize AGENTS.md files in a monorepo using progressive disclosure: maintain a minimal root file with a one-sentence project description and links to domain docs, then place package-specific guidance in nested files to avoid bloat.

What is progressive disclosure for AI agent documentation?

Progressive disclosure for AI agent documentation is an approach that keeps root files minimal and links to separate, domain-specific guidelines, ensuring nested package files hold specific rules rather than hard-coding paths in one bloated file.

How do I refactor a large AGENTS.md file into linked documentation?

Refactor a large AGENTS.md file by extracting domain rules into separate linked files and creating per-package AGENTS.md files, ensuring the root file contains only a project description and links to domain docs.

Can I verify AGENTS.md files for contradictions and stale information?

Yes, you can verify AGENTS.md files to reduce bloat, contradictions, and stale information by running checks that validate the progressive disclosure structure and ensure domain rules live in separate files without hard-coded paths.

Does progressive disclosure work for nested AGENTS.md files in monorepos?

Yes, progressive disclosure works for nested AGENTS.md files in monorepos by applying a minimal root file with links to domain docs and providing package-specific guidance in nested files to maintain organized, scalable documentation.