# agents-md-improver

Скилл agents-md-improver проверяет и улучшает файлы правил проекта, чтобы агент сохранял актуальный контекст. Подходит для ревизии AGENTS.md и CLAUDE.md.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 145 установок · ★ 559 у репозитория
- Автор: waybarrios
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/waybarrios/opencode-power-pack/tree/HEAD/skills/agents-md-improver/SKILL.md
- Обновлён: 2026-10-19
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/agents-md-improver

## Что делает

Скилл ищет файлы правил проекта: `AGENTS.md`, `CLAUDE.md`, локальные переопределения и инструкции в `.agents/instructions`. Затем оценивает их по критериям: команды и рабочие процессы, архитектура, неочевидные соглашения, краткость, актуальность и исполнимость.

Результатом становится отчёт с оценкой каждого файла и перечнем проблем. После этого скилл предлагает точечные правки. Файлы меняются только после подтверждения пользователя.

Скилл рассчитан на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для анализа учитываются правила, применимые к конкретному клиенту; это важно, если в репозитории рядом лежат файлы разных форматов.

## Установка

### Claude Code (родная платформа)

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

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/agents-md-improver/SKILL.md` — Папка скилла целиком; для одного проекта — .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. **Вручную: положить файлы**
- Файл: `.agents/skills/agents-md-improver/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/agents-md-improver/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

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

2. **Вручную: положить файлы**
- Файл: `.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. **Командой платформы**
```bash
gemini skills install https://github.com/waybarrios/opencode-power-pack --path skills/agents-md-improver
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/agents-md-improver/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

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

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/waybarrios/opencode-power-pack/tree/HEAD/skills/agents-md-improver/SKILL.md

## Когда брать
- найти все файлы правил в репозитории
- оценить полноту и актуальность `AGENTS.md`
- выявить устаревшие команды и архитектурные сведения
- составить отчёт по качеству правил
- внести согласованные точечные правки

## Примеры запросов агенту
- Проверь все файлы правил в этом репозитории и составь отчёт.
- Оцени `AGENTS.md` и `CLAUDE.md`, затем предложи точечные улучшения.
- Обнови правила проекта после моего подтверждения отчёта.

## Похожие
- [claude-md-improver](https://affpapa.org/nevibecode/skills/claude-md-improver.md) — скилл · 12558 установок
- [skill-improver](https://affpapa.org/nevibecode/skills/skill-improver.md) — скилл · 5600 установок
- [pr-improver](https://affpapa.org/nevibecode/skills/pr-improver.md) — скилл · 1600 установок
- [skill-based-architecture](https://affpapa.org/nevibecode/skills/skill-based-architecture.md) — скилл · ★ 627 у репозитория
- [prompt-improver](https://affpapa.org/nevibecode/skills/prompt-improver.md) — скилл · 519 установок
- [writing-agents-md](https://affpapa.org/nevibecode/skills/writing-agents-md.md) — скилл · 305 установок

Из того же набора: [waybarrios/opencode-power-pack](https://affpapa.org/nevibecode/by/waybarrios/opencode-power-pack.md) — 7 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
