audit-agents-md

Audit AGENTS.md files for token efficiency, actionability, and scope placement.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/eivindeb/agent-skills --skill audit-agents-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-agents-md
Source: https://github.com/eivindeb/agent-skills/tree/main/audit-agents-md
Command: npx skills add https://github.com/eivindeb/agent-skills --skill audit-agents-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines your agent's instructions by auditing AGENTS.md files for token efficiency, completeness, scope hygiene, and actionability, ensuring your AI agents operate with maximum impact and minimal wasted context.

Core Features & Use Cases

  • Token Efficiency Audit: Identifies directives that are redundant, vague, or already covered by default agent behavior or existing skills.
  • Actionability Assessment: Ensures instructions are specific and unambiguous for the agent to follow.
  • Scope and Placement Analysis: Recommends optimal placement of directives across AGENTS.md files, skills, and Cursor rules.
  • Completeness Check: Highlights missing high-value directives, such as verification matrices or architectural boundaries.
  • Use Case: Before a major refactor, use this skill to audit your project's AGENTS.md files to ensure all agent instructions are concise, relevant, and correctly scoped, preventing confusion and improving agent performance.

Quick Start

Audit all AGENTS.md files in the current repository for token efficiency and actionability.

Frequently Asked Questions about audit-agents-md

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

FAQPage Schema
How do I optimize AGENTS.md files for token efficiency and agent clarity?

To optimize AGENTS.md files for token efficiency, you can audit them to identify redundant, vague, or duplicated directives, ensuring your AI agents operate with maximum impact and minimal wasted context.

What is the best way to audit AI agent instructions for actionability?

Auditing AI agent instructions for actionability involves analyzing directives to ensure they are specific and unambiguous, checking that every instruction provides clear, actionable guidance for the agent to follow.

How do I determine the correct scope placement for directives across AGENTS.md and Cursor rules?

Determining correct scope placement requires analyzing directives to recommend optimal placement across AGENTS.md files, skills, and Cursor rules, preventing duplication and improving overall agent performance.

Why does my AI agent ignore instructions in my AGENTS.md file?

Your AI agent might ignore AGENTS.md instructions if they are verbose, lack unambiguous actionability, or duplicate existing skills, which causes a drop in token ROI and overall instruction effectiveness.

Can I check AGENTS.md files for missing high-value directives before a major refactor?

Yes, you can check AGENTS.md files for completeness to highlight missing high-value directives, such as verification matrices or architectural boundaries, ensuring all instructions are concise and relevant before refactoring.