Три аббревиатуры, три разных слоя одной и той же задачи — сделать AI-агента полезным именно для вашего проекта. Путаница возникает не потому, что концепции сложные, а потому, что они решают смежные, но принципиально разные проблемы.
Три слоя одной задачи
AGENTS.md отвечает на вопрос “что агенту нужно знать про этот конкретный проект” — стек, конвенции, границы дозволенного. Загружается целиком при каждом обращении. SKILL.md отвечает на вопрос “как выполнить конкретную повторяющуюся процедуру” — деплой, миграция, генерация отчёта. Загружается только при совпадении с задачей. MCP отвечает на вопрос “к каким внешним системам агент может обратиться” — база данных, Sentry, GitHub API.
| Слой | Вопрос, на который отвечает | Загружается |
|---|---|---|
| AGENTS.md | Что за проект и какие тут правила | Целиком, всегда |
| SKILL.md | Как выполнить конкретную процедуру | По совпадению с задачей |
| MCP | К каким внешним системам есть доступ | При использовании соответствующего инструмента |
Пример, где нужны все три одновременно
AGENTS.md: "Проект на Next.js, TypeScript strict, коммиты по Conventional Commits"
SKILL.md "deploy-staging": пошаговая процедура деплоя в staging окружение
mcp.json "sentry": доступ к логам ошибок продакшена через MCP-сервер SentryАгент читает AGENTS.md, чтобы понять общий контекст проекта. Когда задача касается деплоя — подгружает skill deploy-staging с конкретными шагами. Если нужно проверить, не воспроизводится ли баг в проде — обращается к MCP-серверу Sentry за реальными логами ошибок.
Частая ошибка — смешение слоёв
Разовая процедура деплоя, записанная прямо в AGENTS.md вместо отдельного SKILL.md, грузится в контекст при каждой задаче, даже когда она про исправление опечатки в README. Доступ к внешней системе, реализованный через bash-скрипт внутри skill вместо нормального MCP-сервера, теряет структурированный интерфейс инструмента и типизацию параметров, которые MCP даёт из коробки.
Практическая рекомендация
Начинайте с AGENTS.md — это фундамент, который нужен почти всегда. Добавляйте SKILL.md по мере накопления повторяющихся процедур, которые не нужны в каждой задаче. Подключайте MCP-серверы, когда агенту реально нужен структурированный доступ к внешней системе, а не просто чтение локальных файлов.
Как разобраться в конкретных механиках каждого слоя
На сайте есть отдельные инструменты и гайды под каждый из трёх слоёв: конвертер AGENTS.md/CLAUDE.md/Cursor Rules, валидатор SKILL.md, и конвертер mcp.json между клиентами.
Итоговый чеклист
AGENTS.md, SKILL.md и MCP решают три разных вопроса — общий контекст проекта, конкретные процедуры и доступ к внешним системам — а не конкурируют друг с другом.
Разовая процедура в AGENTS.md вместо отдельного SKILL.md тратит контекст впустую при каждой задаче, где она не нужна.
Хороший проект обычно использует все три слоя одновременно, каждый для своей конкретной роли.