Что такое скиллы AI-агента и чем они отличаются от MCP, правил и промпта

Знакомая ситуация: вы уже в пятый раз объясняете агенту, как у вас готовят SEO-аудит или отвечают на отзывы. Он делает хорошо — до следующей сессии, где всё приходится повторять. А коллега, который попросит то же самое своими словами, получит совсем другой результат.

Скиллы решают именно эту проблему. Процесс описывают один раз, кладут в понятное место, и агент сам подгружает инструкцию, когда встречает подходящую задачу.

Это открытый формат со спецификацией: его понимают Claude Code, Codex и другие агенты. Ниже — как он устроен, чем отличается от соседних понятий, как написать свой скилл и когда он проигрывает обычному файлу правил.

Скилл простыми словами

Скилл — это папка, внутри которой лежит файл SKILL.md с инструкцией для одной конкретной работы. Больше обязательного ничего нет. По желанию рядом кладут:

• scripts/ — скрипты, которые агент может запустить;
• references/ — справочные материалы, которые он читает при необходимости;
• assets/ — шаблоны, примеры, таблицы, картинки.

Удобная аналогия — папка с инструкцией по одной операции на полке у сотрудника. Он не держит в голове все инструкции компании сразу, а знает, что они есть, и берёт нужную, когда дошёл до задачи.

Сам SKILL.md состоит из двух частей. Сверху — короткий блок с названием и описанием, ниже — обычный текст инструкции:

---
name: otvet-na-otzyv
description: Пишет ответ компании на отзыв клиента на Яндекс.Картах,
  2ГИС или Google. Используй, когда просят ответить на отзыв,
  разобрать негатив или подготовить ответ на жалобу.
---

# Ответ на отзыв

## Шаги
1. Определи тон отзыва: негатив, нейтральный, позитив.
2. Для негатива сначала перескажи проблему своими словами,
   потом — что уже сделано или будет сделано.
3. Не спорь с клиентом публично и не обещай компенсаций.
4. Проверь ответ по стоп-списку из references/stop-words.md.

## Пример
Отзыв: «Ждали заказ два часа, никто не предупредил».
Ответ: «Два часа ожидания без предупреждения — это наша ошибка…»

Как агент решает, какой скилл подгрузить

Главная инженерная идея формата — загрузка по частям. Если бы агент при старте читал все установленные скиллы целиком, контекст заканчивался бы ещё до задачи. Поэтому спецификация раскладывает скилл на три уровня:

1. Название и описание — около 100 токенов на скилл. Загружаются при старте для всех скиллов сразу.
2. Инструкция целиком — рекомендуется до 5000 токенов. Загружается, только когда агент решил, что скилл подходит к задаче.
3. Файлы и скрипты — подгружаются, только если инструкция на них сослалась и они действительно понадобились.

Из этого следует вывод, который многие пропускают: самая важная строка скилла — описание. Именно по нему агент решает, брать скилл или нет. Хорошая инструкция с плохим описанием просто никогда не сработает.

Спецификация даёт наглядный пример. «Помогает с PDF» — плохое описание. «Извлекает текст и таблицы из PDF, заполняет формы, объединяет файлы. Используй, когда пользователь работает с PDF, формами или извлечением данных из документов» — хорошее. В нём есть что делает скилл, когда его использовать и слова, которыми человек обычно формулирует такую просьбу.

Скиллы, MCP, правила и промпт: кто за что отвечает

Эти понятия постоянно путают, хотя они решают разные задачи и хорошо работают вместе.

Что	Отвечает на вопрос	Когда действует	Пример
Системный промпт и файл правил проекта (CLAUDE.md, AGENTS.md)	Кто ты и как мы здесь работаем	Всегда, в каждом шаге	Тон текстов, запреты, устройство проекта
Скилл	Как выполнить конкретную работу	Когда задача подходит под описание	SEO-аудит страницы, типографика, ответ на отзыв
MCP-сервер	К каким внешним системам есть доступ	Подключён постоянно, вызывается по надобности	Почта, CRM, база данных, календарь
Инструмент	Одно конкретное действие	По вызову	Прочитать файл, выполнить поиск

Короче всего так: правила — про то, как вести себя всегда; скилл — про то, как сделать одну работу; MCP — про то, до чего можно дотянуться. Скилл вполне может в своих шагах пользоваться инструментами MCP-сервера: например, собрать данные из CRM и оформить отчёт по заданному шаблону.

Когда постоянный файл правил работает лучше скилла

У загрузки по требованию есть обратная сторона: агент может не решить, что скилл нужен. Это не теория — Vercel проверил на тестах.

Задача была практическая: научить агента новым API фреймворка Next.js 16, которых ещё нет в обучающих данных моделей. Сравнили четыре варианта:

Что показали тесты:

• Скилл был, но агент его не звал. В 56% случаев скилл просто не вызывался, и результат совпал с вариантом вообще без документации.
• Явная инструкция помогла, но оказалась хрупкой. Строчка в AGENTS.md «вызови скилл» подняла результат до 79%. Однако от формулировки зависело многое: «сразу вызови скилл» давало худший результат, чем «сначала изучи проект, потом вызови скилл».
• Указатель в постоянном файле дал 100%. Не вся документация, а сжатый до 8 КБ список того, где лежат нужные файлы. Агенту больше не нужно решать, заглядывать ли в документацию: указатель уже у него перед глазами, остаётся открыть нужный файл.

Сам Vercel не делает вывод «скиллы бесполезны». Постоянный файл лучше подходит для общих знаний, нужных почти в каждой задаче, а скиллы — для отдельных операций, которые запускают по поводу: обновить версию, провести миграцию, сделать аудит.

Отсюда простое правило, куда класть знание:

flowchart TD
    A["Знание или процесс"] --> B{"Нужно почти<br/>в каждой задаче?"}
    B -->|да| R["В файл правил проекта<br/>CLAUDE.md или AGENTS.md"]
    B -->|нет| C{"Это отдельная операция,<br/>которую запускают по поводу?"}
    C -->|да| S["В скилл"]
    C -->|нет| D{"Нужен доступ<br/>к внешней системе?"}
    D -->|да| M["Подключить<br/>MCP-сервер"]
    D -->|нет| P["Хватит обычного<br/>промпта в задаче"]
    S --> E{"Шаг должен выполняться<br/>одинаково каждый раз?"}
    E -->|да| X["Скрипт внутри скилла"]
    E -->|нет| Y["Текст инструкции"]

Этот блог устроен ровно так. Всё, что нужно в каждой задаче, — правила тона, где лежат картинки, как публикуется статья, — записано в постоянном файле правил проекта. А отдельные операции — расстановка типографики, SEO-аудит, копирайтинг, поиск штампов — подключены скиллами и срабатывают, когда до них доходит дело.

Как написать свой скилл

1. Выберите одну повторяющуюся операцию. Не «всё про маркетинг», а «ответ на отзыв», «аудит лендинга», «еженедельный отчёт по рекламе». Чем уже задача, тем точнее агент поймёт, когда её брать.

2. Дайте имя по правилам спецификации. До 64 символов, только строчные латинские буквы, цифры и дефис. Нельзя начинать или заканчивать дефисом и ставить два дефиса подряд. Имя должно совпадать с названием папки: otvet-na-otzyv/SKILL.md.

3. Потратьте больше всего времени на описание. До 1024 символов. Три обязательных элемента: что делает скилл, когда его использовать и какими словами о таком обычно просят. Если сомневаетесь, добавьте синонимы: «отзыв», «жалоба», «негатив», «ответить клиенту».

4. Напишите инструкцию. Шаги, пример входа и выхода, частые исключения. Файл лучше держать короче 500 строк, а длинные справочники вынести в references/ и сослаться на них из текста. Ссылки — на один уровень вглубь, без цепочек «файл ссылается на файл, который ссылается на файл».

5. Шаги, которые должны быть одинаковыми каждый раз, превратите в скрипты. Посчитать метрики, проверить формат, выгрузить данные. Скрипт надёжнее абзаца текста: агенту не нужно заново выводить процедуру, а проверить скрипт проще, чем инструкцию.

6. Проверьте две вещи. Формат проверяется командой skills-ref validate ./otvet-na-otzyv из официальной библиотеки. А срабатывание — только живыми запросами: попросите агента о задаче своими словами, как попросил бы коллега, и посмотрите, подхватил ли он скилл. Не подхватил — правьте описание, а не инструкцию.

Где взять готовые скиллы

Готовые наборы собраны в каталоге skills.sh, а ставятся одной командой вида npx skills add <автор/репозиторий>. В блоге уже есть разборы нескольких наборов — от маркетинговых до инженерных:

Безопасность: скилл — это чужие инструкции и чужой код

Скилл меняет поведение агента, а скрипты внутри него выполняются на вашей машине. Поэтому к установке стоит относиться как к запуску чужой программы:

• Прочитайте SKILL.md и скрипты до установки. Особенно если скилл обращается к сети, файлам или ключам.
• Фиксируйте версию. Обновление набора — это новый код, который тоже стоит посмотреть.
• Предпочитайте проверяемое. Короткий понятный скилл от известного автора лучше большого набора, в котором непонятно, что происходит.
• Не рассчитывайте на ограничения. В спецификации есть поле для заранее разрешённых инструментов, но оно помечено как экспериментальное, и разные агенты поддерживают его по-разному.

Вывод

Скилл — это упакованная инструкция для одной работы, которую агент берёт с полки, когда встречает подходящую задачу. Сила формата в загрузке по частям, а слабое место — в том же: агент может не решить, что скилл нужен. Поэтому всё, что нужно почти всегда, лучше держать в постоянном файле правил, а в скиллы выносить отдельные операции — и тщательно писать им описание.

Следующий шаг: вспомните процесс, который вы объясняли агенту больше трёх раз за последний месяц. Напишите для него SKILL.md с описанием по формуле «что делает, когда использовать, какими словами просят» — и проверьте, подхватит ли агент скилл, если попросить своими словами.

Хотите упаковать свои процессы в скиллы и правила для агента — напишите мне в Telegram.