Skip to main content
skill CX Codex

agents-md-improver — Claude Code skill

agents-md-improver audits project rule files and suggests focused updates so coding agents retain current repository context. Use it when AGENTS.md or CLAUDE.md needs review.

no license 145 installs ★ 559 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a claude-code
Open on GitHub

What agents-md-improver does

The skill searches a repository for rule files such as AGENTS.md, CLAUDE.md, local overrides, and .agents/instructions. It scores each relevant file against checks for commands, architecture, unusual patterns, concision, freshness, and actionable guidance.

It then produces a file-by-file quality report with scores, issues, and suggested additions. Proposed changes stay targeted. The skill edits project rule files only after the user approves the report.

It supports Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Client-specific rule behavior matters when several rule formats coexist in one repository.

What it helps with

  • locate every project rule file
  • score the coverage of AGENTS.md
  • spot stale commands and architecture notes
  • produce a file-by-file quality report
  • apply approved focused edits

Example prompts for the agent

  • Audit every project rule file and show me the quality report.
  • Review AGENTS.md and CLAUDE.md, then suggest focused fixes.
  • After I approve the report, update the project rules.

How to install agents-md-improver

1Skills CLI (Vercel)

npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a claude-code

2Manually: put the files in place

~/.claude/skills/agents-md-improver/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agents-md-improver/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agents-md-improver

How do I install agents-md-improver in Claude Code?

Run npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a claude-code, then check ~/.claude/skills/agents-md-improver/SKILL.md.

What does agents-md-improver do?

It finds project rule files, grades them against a quality rubric, and creates a file-by-file report. It makes focused edits only after the user approves them.

Which project rule files can it review?

It reviews files such as AGENTS.md, CLAUDE.md, local overrides, and .agents/instructions, while applying the rules supported by the selected client.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set7

Project sponsors

Companies that keep this analytics open