agent-md-management

This Skill addresses the issues of project AGENTS.md documentation falling out of sync with the codebase, inconsistent content quality, and the difficulty of continuous updates. In practical development, developers often need to manually maintain this critical project memory file. However, with frequent code changes, it's easy to miss updates, leading to outdated documentation. This prevents newly added AI agents from obtaining accurate project context, severely impacting development efficiency.

Usage is straightforward. Simply install the skill package, and you can then trigger its two core functions via natural language commands. One is to use the /audit my AGENTS.md files command for periodic auditing. The skill will automatically scan all AGENTS.md files, compare them against the current state of the codebase, generate a detailed quality report, and suggest improvements. The other is to use the /revise-agent-md command at the end of a session. It will review the current session's content, capture newly discovered patterns, commands, or considerations, and present and apply updates to the AGENTS.md file in diff format.

It is ideal for development teams or individuals managing complex projects who want their AI coding assistants (like Claude Code, Cursor, etc.) to consistently receive accurate project context. This is especially true for those who have already established AGENTS.md as project memory but struggle with the high cost of manual maintenance and the tendency to forget updates. For full-stack developers, agent developers, and project managers, it ensures the project's knowledge assets remain fresh and usable.

It is recommended to use this tool after significant changes to the codebase or at the conclusion of important development sessions. Note that it primarily relies on static analysis of the codebase and review of session context. For extremely obscure project rules not reflected in the code or sessions, manual supplementation is still required. For first-time use, it's advised to run the audit function first to comprehensively assess the quality of existing documentation.