agents-md-lint

Audit and trim AI agent instruction files to remove redundant documentation.

7|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/borkweb/skills --skill agents-md-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md-lint
Source: https://github.com/borkweb/skills/tree/main/skills/core/agents-md-lint
Command: npx skills add https://github.com/borkweb/skills --skill agents-md-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the auditing and pruning of AI agent instruction files to remove redundant information, thereby conserving valuable context tokens for more efficient AI operations.

Core Features & Use Cases

  • Automated Auditing: Analyzes AI agent instruction files for unnecessary facts that can be derived from code.
  • Optimization: Identifies and removes documentation that consumes context tokens, improving AI performance.
  • Use Case: If you are dealing with a repository of AI agent instruction files, this Skill will help you streamline these files, ensuring your AI has more context tokens to work with.

Quick Start

Run the 'agents-md-lint' skill to remove redundant documentation from your instruction files.

Frequently Asked Questions about agents-md-lint

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

FAQPage Schema
How do I reduce redundant context tokens in AI agent instruction files?

You can eliminate redundant context tokens by auditing and trimming AI agent instruction files to remove documentation that can be derived from the codebase. This optimization frees up context tokens for more efficient AI performance.

What are AI agent instruction files and why do they need pruning?

AI agent instruction files like AGENTS.md, CLAUDE.md, CONVENTIONS.md, and .cursorrules provide guidelines for AI coding assistants. They require pruning when redundant documentation consumes context tokens and limits the AI's available working context.

Does agents-md-lint work with CLAUDE.md and .cursorrules files?

Yes, the auditing and trimming process supports repositories containing CLAUDE.md and .cursorrules files, as well as AGENTS.md and CONVENTIONS.md. It analyzes these files to identify and remove documentation that can be derived from code.

How do I audit AGENTS.md files to remove information derivable from code?

You audit AGENTS.md files by running an automated process that utilizes a sub-agent to simulate blind auditing from code-only context. This identifies unnecessary facts that can be derived from the codebase for removal.

Do I need codebase access to analyze and trim CONVENTIONS.md files?

Yes, codebase access is required to analyze and trim CONVENTIONS.md files. The auditing process must compare the instruction file documentation against the code to determine which facts are redundant and can be removed.