agents-md-improver

name	agents-md-improver
description	Proposes updates to AGENTS.md so repo-local coding-agent instructions stay accurate, non-contradictory, and consolidated. Use when the user corrects the agent (e.g. do not do X, always do Y, from now on, remember this), asks to edit or sync AGENTS.md, CLAUDE.md, .claude/CLAUDE.md, or GEMINI.md, wants one canonical instruction file or to deduplicate agent docs, or flags conflicting or outdated repository agent rules.
license	MIT

AGENTS.md improver

This skill helps keep repository instructions accurate and consistent. When a user corrects the coding agent's behavior, treat it as a potential update to the repo's instruction files and propose a clean, integrated edit to AGENTS.md.

Usage

Use this skill anytime the user:

• Corrects the agent ("don't do X", "do Y instead", "from now on...", "remember to...", "add a rule that...").
• Asks to update instruction files like AGENTS.md, CLAUDE.md, .claude/CLAUDE.md, or GEMINI.md, or to align or consolidate those files.
• Notices contradictions, duplication, or drift between repository instruction files.

Requirements

• Repo-local file access to read and edit AGENTS.md.
• If present in the repo, read access to CLAUDE.md and/or .claude/CLAUDE.md.

What It Does

• Proposes a patch to incorporate the user's correction into AGENTS.md seamlessly.
• Looks for contradictions and resolves them in the proposal (or asks for clarification when needed).