# agents-md-improver

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 145 installs · ★ 559 repo stars
- Author: waybarrios
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/waybarrios/opencode-power-pack/tree/HEAD/skills/agents-md-improver/SKILL.md
- Updated: 2026-10-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agents-md-improver

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agents-md-improver/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agents-md-improver/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agents-md-improver/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agents-md-improver/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install waybarrios/opencode-power-pack skills/agents-md-improver
```

2. **Manually: put the files in place**
- File: `.github/skills/agents-md-improver/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/waybarrios/opencode-power-pack --path skills/agents-md-improver
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agents-md-improver/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill agents-md-improver -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/waybarrios/opencode-power-pack/tree/HEAD/skills/agents-md-improver/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [claude-md-improver](https://affpapa.org/en/nevibecode/skills/claude-md-improver.md) — skill · 12558 installs
- [skill-improver](https://affpapa.org/en/nevibecode/skills/skill-improver.md) — skill · 5600 installs
- [pr-improver](https://affpapa.org/en/nevibecode/skills/pr-improver.md) — skill · 1600 installs
- [skill-based-architecture](https://affpapa.org/en/nevibecode/skills/skill-based-architecture.md) — skill · ★ 627 repo stars
- [prompt-improver](https://affpapa.org/en/nevibecode/skills/prompt-improver.md) — skill · 519 installs
- [writing-agents-md](https://affpapa.org/en/nevibecode/skills/writing-agents-md.md) — skill · 305 installs

From the same set: [waybarrios/opencode-power-pack](https://affpapa.org/en/nevibecode/by/waybarrios/opencode-power-pack.md) — 7 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
