agents-md-improver
Keeps repo-local agent instructions consistent by proposing updates to AGENTS.md when a user corrects the coding agent or asks to change AGENTS.md, CLAUDE.md, .claude/CLAUDE.md, or GEMINI.md.
npx skills add majiayu000/claude-skill-registry --skill agents-md-improver-ericmjl-skills-a65767d0 --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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..."). - Asks to update instruction files like `AGENTS.md`, `CLAUDE.md`, `.claude/CLAUDE.md`, or `GEMINI.md`. - Notices contradictions between instructions. ## 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). - If repo-local `CLAUDE.md` or `.claude/CLAUDE.md` exists, proposes consolidating instructions into `AGENTS.md`, then offers follow-up options to delete, symlink, or stub those files. ## How It Works ### Scope This skill is repo-specific. - Only consider repo-local instruction files: - `AGENTS.md` - `CLAUDE.md` (repo root)
- Usage
- Requirements
- What It Does
- How It Works
- Scope
- Propose-first workflow (do not auto-edit)
- Seamless integration rules
- Contradiction checks
- Consolidation flow for CLAUDE.md files (if present)
- Notes for multi-instruction environments
What does the agents-md-improver skill do?
Keeps repo-local agent instructions consistent by proposing updates to AGENTS.md when a user corrects the coding agent or asks to change AGENTS.md, CLAUDE.md, .claude/CLAUDE.md, or GEMINI.md.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agents-md-improver-ericmjl-skills-a65767d0 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.