agents-md-improver

Audit and optimize repository-scoped Codex instruction chains in AGENTS.md files.

16|1|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/bahayonghang/my-ai-cli-toolkit --skill agents-md-improver-bahayonghang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md-improver
Source: https://github.com/bahayonghang/my-ai-cli-toolkit/tree/main/skills/developer-tools-integrations/agents-md-improver
Command: npx skills add https://github.com/bahayonghang/my-ai-cli-toolkit --skill agents-md-improver-bahayonghang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill resolves inconsistencies and gaps in repository-scoped Codex instruction chains, ensuring your AI agents follow the correct guidance for your specific project context.

Core Features & Use Cases

  • Instruction Audit: Analyzes the effective chain of AGENTS.md and AGENTS.override.md files to identify shadowed or missing instructions.
  • Navigation Mapping: Generates and maintains code_map.md files to improve AI navigation in complex repositories.
  • Use Case: Use this tool when your AI agent is ignoring project-specific rules or failing to find relevant files in a large, multi-module codebase.

Quick Start

Invoke the agents-md-improver skill to audit the current repository guidance and provide a report of findings and proposed improvements.

Frequently Asked Questions about agents-md-improver

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

FAQPage Schema
How do I audit AGENTS.md files for my repository?

To audit AGENTS.md files, this Skill analyzes the effective chain of AGENTS.md and AGENTS.override.md files to identify shadowed or missing instructions, ensuring your AI agents follow the correct project-specific guidance.

Why does my AI agent ignore project-specific rules in a large codebase?

Your AI agent might ignore project-specific rules due to gaps or inconsistencies in the repository-scoped Codex instruction chains. This Skill audits AGENTS.md files to resolve these issues and generate navigation maps for complex repositories.

What's the best way to generate a navigation map for AI in complex repositories?

The best way to generate a navigation map is by using this Skill to maintain code_map.md files, which directly improves AI navigation in large, multi-module codebases by optimizing repository guidance.

How do I clean up stale commands in AGENTS.override.md?

Cleaning up stale commands in AGENTS.override.md requires auditing the repository-scoped Codex instruction chains. This Skill validates and applies instruction updates to resolve inconsistencies and remove outdated commands.

Does optimizing Codex guidance require write access to repository configuration files?

Yes, optimizing Codex guidance requires both read and write access to repository configuration files. This access is necessary to validate the instruction chains and apply the proposed instruction updates.

When should I not use an AGENTS.md instruction audit?

You should avoid an AGENTS.md instruction audit if you lack write access to repository configuration files, as this Skill needs those permissions to validate and apply the necessary instruction updates.