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

> Простое объяснение Agent Skills: из чего состоит скилл, как агент решает его подгрузить, чем скиллы отличаются от MCP, CLAUDE.md и системного промпта, как написать свой SKILL.md и когда постоянный файл правил работает лучше.

Источник: https://blog.uspeshnyy.ru/blog/chto-takoe-skilly-ai-agenta/
Автор: Александр Успешный · blog.uspeshnyy.ru
Опубликовано: 2026-03-16
Теги: AI-агенты, Claude, промпты, инструменты

---

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

![Скилл грузится по частям: название и описание — всегда, инструкция — когда подходит, файлы и скрипты — по необходимости](/images/posts/chto-takoe-skilly-ai-agenta-2.webp)

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

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

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

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

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

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

![Кто за что отвечает: правила — всегда, скилл — по задаче, подключения — доступ, инструмент — одно действие](/images/posts/chto-takoe-skilly-ai-agenta-1.webp)

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

У загрузки по требованию есть обратная сторона: агент может **не решить**, что скилл нужен. Это не теория — Vercel [проверил на тестах](https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<div class="post-refs">
<a href="/blog/marketing-skills-50-gotovyh-navykov-dlya-ai-agenta-v-termina/">50+ маркетинговых навыков: SEO, CRO, тексты, аналитика — с общим контекстом между модулями</a>
<a href="/blog/matt-pocock-skills/">инженерный набор, где агент сначала допрашивает вас, пишет спецификацию и только потом код</a>
<a href="/blog/otdel-marketinga-na-claude-code/">33 навыка и один файл-начальник, который распределяет между ними задачи</a>
<a href="/blog/ponytail-kak-nauchit-ai-agenta-ne-generirovat-lishniy-kod/">набор правил, который учит агента не писать лишний код</a>
</div>

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

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

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

## Вывод

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

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

Хотите упаковать свои процессы в скиллы и правила для агента — [напишите мне в Telegram](https://t.me/uspeshnyy).