agents-md

Audit AGENTS.md files against quick-checklist and quality criteria.

75|6|Updated Jan 12, 2026

Search Tags:#workflow #documentation #audit #refactor #agents.md #gotchas

Ready to run

npx skills add https://github.com/mblode/agent-skills --skill agents-md-mblode

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/mblode/agent-skills/tree/main/skills/agents-md
Command: npx skills add https://github.com/mblode/agent-skills --skill agents-md-mblode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits AGENTS.md to ensure concise, actionable, and up-to-date agent instructions that reduce mistakes and bloated guidance.

Core Features & Use Cases

Quick audits validate against the quick-checklist for fast triage.
Full audits apply the quality criteria to high-risk or high-impact files and produce structured change proposals.
Progressive disclosure links deeper references and reduces root-file bloat while preserving essential rules.

Quick Start

Run a quick audit on AGENTS.md using the quick-checklist and summarize findings with a minimal diff plan.

Frequently Asked Questions about agents-md

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

FAQPage Schema

How do I audit AGENTS.md files for execution-first accuracy?▼

Auditing AGENTS.md files involves running quick checks for fast triage or full audits that apply quality criteria to produce structured change proposals with rationale and diffs.

What is the best way to refactor bloated agent instructions in a monorepo?▼

The best way to refactor bloated agent instructions in a monorepo is applying progressive disclosure to link references, reducing root-file bloat while preserving essential rules across nested AGENTS.md files.

Can I run a quick AGENTS.md audit for fast triage?▼

Yes, you can run a quick AGENTS.md audit that validates files against a quick-checklist, summarizing findings with a minimal diff plan for immediate triage and improvements.

How does progressive disclosure reduce AGENTS.md root-file bloat?▼

Progressive disclosure reduces AGENTS.md root-file bloat by linking to standard references instead of inlining all details, preserving concise actionable rules while keeping deeper documentation accessible.

When should I use a full audit over a quick audit for agent documentation?▼

Use a full audit over a quick audit for high-risk or high-impact AGENTS.md files, as it applies comprehensive quality criteria and produces a structured change proposal with detailed rationale and diffs.

Why does my AGENTS.md workflow documentation contain unnecessary guidance?▼

AGENTS.md workflow documentation contains unnecessary guidance when it lacks execution-first constraints, omitting structured change proposals that enforce concise, actionable, and up-to-date instructions.