# AI Audit Agents Md

> Используй, когда нужно проверить один или несколько `AGENTS.md` на машинную пригодность, конфликты, лишний контекст и соседние инструкции.

- Skill: `mekras/ai-audit-agents-md` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add mekras/ai-audit-agents-md`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mekras/ai-audit-agents-md/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: mekras (https://skillmd.com/u/mekras)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mekras/ai-audit-agents-md

---


# Навык: проверка AGENTS.md

Если аудит ведёт к существенной правке источника истины, сначала получи
`ai-work-control/full`; сам аудит не повторяет этот контроль.

Используй этот навык для независимой проверки одного или нескольких
`AGENTS.md` как машинной точки входа и для проверки соседних instruction-файлов,
которые читает конкретная обвязка, например `CLAUDE.md`: кратких,
операционных, детерминированных и не перегруженных сведениями, которые лучше
держать в `README.md`, вложенных инструкциях или профильных документах.

## Когда применять

Применяй навык, если нужно:

- проверить существующий `AGENTS.md`;
- проверить набор файлов `AGENTS.md` в одном репозитории;
- проверить, не нужен ли рядом `CLAUDE.md` или другой instruction-файл для
  конкретной обвязки и не создаёт ли он второй источник истины;
- оценить, не перегружен ли `AGENTS.md`;
- проверить, не смешаны ли машинный и человеческий входы;
- проверить, не конфликтуют ли корневой и вложенные `AGENTS.md`;
- подготовить замечания перед изменением `AGENTS.md`.

Если задача требует не только проверки, но и создания, изменения, сокращения
или разделения `AGENTS.md`, сначала используй `ai-agents-md-maintenance`, а этот
навык применяй как независимый контроль результата.

Не применяй навык для общей проверки всей документации проекта, если задача не
сосредоточена на `AGENTS.md` и соседних инструкциях.

## Входные данные

Для применения навыка должны быть доступны настолько, насколько это возможно:

- проверяемый файл или набор файлов `AGENTS.md`;
- соседние файлы инструкций, если они участвуют в цепочке применения;
- `README.md` и другие документы, на которые ссылается `AGENTS.md`;
- сведения о структуре репозитория, если проверяется вложенность инструкций;
- проверяемые источники, если нужно подтвердить основание замечания.

Если часть цепочки инструкций недоступна, зафиксируй это ограничение явно.

## Обязательный порядок

1. Определи контур инструкций: какие файлы реально участвуют в управлении
   агентом и можно ли восстановить порядок применения. Если проект использует
   обвязку, читающую не `AGENTS.md`, а соседний instruction-файл, например
   `CLAUDE.md`, включи его в проверку контура.
2. Проверь роль `AGENTS.md` как машинного входа: нет ли подмены README, длинного
   обзора проекта или общих пожеланий вместо рабочих правил.
3. Проверь связку соседних instruction-файлов: не дублируют ли `AGENTS.md` и
   `CLAUDE.md` один и тот же текст вручную, нет ли расхождения между ними и
   не зависит ли корректность поведения от неописанного порядка их слияния.
4. Проверь минимальную достаточность контекста: каждое правило должно менять
   поведение агента в реальной задаче.
5. Проверь детерминизм и конфликты: противоречия, неявные переопределения,
   спорящие обязанности и расплывчатые условия применения.
6. Проверь операционность: команды, пути, роли, форматы, условия и точки
   остановки должны быть указаны там, где без них правило не выполняется.
7. Проверь границы между переносимым и локальным: временные гипотезы,
   проектные особенности и будущие идеи не должны выглядеть как универсальное
   правило.
8. Подготовь отчёт: сначала замечания по важности, затем открытые вопросы и
   ограничения проверки.

## Что читать дополнительно

- `references/review-checklist.md` — детальный чек-лист проверки `AGENTS.md` и
  связанных инструкционных файлов.

## Формат результата

Результатом должен быть отчёт пользователю, в котором:

- замечания перечислены по важности;
- для каждого замечания указано, где именно проблема;
- для каждого замечания указано, какое проверяемое правило оно нарушает;
- отделены наблюдаемый факт, вывод и предлагаемое исправление;
- нет лишнего пересказа разделов без проблем.

Если существенных замечаний нет, скажи это прямо и отдельно назови остаточные
риски проверки.

## Ошибки применения

Ошибкой считается:

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

## Связь с другими навыками

- `ai-agents-md-maintenance` — когда по результатам проверки нужно создать,
  изменить, сократить или разделить `AGENTS.md`.
- `ai-data-collection` — когда нужно собрать контекст по нескольким файлам
  инструкций и связанным документам.
- `ai-work-control` — когда замечания ведут к изменению источника истины.
- `ai-work-result-evaluation` — когда отчёт будет принят как основание для
  изменения проектных инструкций.