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
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a claude-codeWhat 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.mdandCLAUDE.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-code2Manually: put the files in place
~/.claude/skills/agents-md-improver/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agents-md-improver/
1Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a codex2Manually: put the files in place
.agents/skills/agents-md-improver/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a cursor2Manually: put the files in place
.cursor/skills/agents-md-improver/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install waybarrios/opencode-power-pack skills/agents-md-improver2Manually: put the files in place
.github/skills/agents-md-improver/SKILL.md1Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a gemini-cli2Platform CLI
gemini skills install https://github.com/waybarrios/opencode-power-pack --path skills/agents-md-improverManually: put the files in place
.devin/skills/agents-md-improver/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.