Скилл звучит как что-то техническое, а внутри — папка с текстовым файлом. Ни строчки кода, ни установки, ни программирования. Разбираем по деталям: что лежит внутри, какие поля обязательны, почему сотня скиллов не тормозит агента и каким скилл должен быть, чтобы им реально пользовались.
Эти три слова встречаются рядом и звучат одинаково загадочно. На деле они про разное — и разбираются по очереди, а не через «не путайте».
Папка с текстовым файлом, в котором написано: как правильно делается конкретный тип работы. Как разобрать выгрузку, как ответить клиенту на претензию, как проверить договор перед подписанием.
Агент читает описание скилла и сам понимает, что задача под него подходит. Это как должностная инструкция специалиста: она не даёт человеку новых рук, она задаёт порядок действий.
Открытый стандарт, по которому AI-приложение соединяется с внешними системами: почтой, базой данных, Notion, поиском в интернете, вашей 1С. Официальная аналогия авторов протокола — разъём USB-C для AI: один общий формат вместо отдельного переходника под каждый сервис.
MCP не знает, как делать работу хорошо. Он даёт доступ: получить данные, выполнить действие, взять готовый шаблон запроса.
Само по себе слово переводится как «упряжь». Модель — это двигатель: она умеет рассуждать, но ничего не помнит и ни к чему не подключена. Харнесс — всё, что вы навешиваете вокруг неё, чтобы получился работник.
Правила (CLAUDE.md), память между сессиями, скиллы, подключения по MCP, автодействия на события, помощники-субагенты и настройки разрешений — вот это в сумме и есть харнесс. Модель у всех одинаковая; отличается именно обвязка. Поэтому у одного Claude «гениальный», а у другого «тупит»: разный харнесс, а не разный AI.
Скилл «аналитик конкурентов» знает, что и в каком порядке смотреть. MCP-поиск даёт ему возможность реально сходить в интернет. Харнесс — то, в чём это всё живёт и запускается: ваша папка, ваши правила, ваша память о прошлых разборах.
Убери скилл — агент пойдёт наугад. Убери MCP — ему нечем сходить за данными. Убери харнесс — он забудет вас к завтрашнему утру.
Минимальный скилл — это папка и один файл в ней. Всё остальное необязательно и добавляется, когда понадобится.
Обычный текстовый файл в формате Markdown. Сверху — короткая служебная шапка между двумя строчками из трёх дефисов, ниже — сам текст инструкции.
--- name: razbor-vygruzki description: Разбор выгрузок из 1С: остатки, продажи, дебиторка. Использовать, когда пользователь присылает CSV или Excel из 1С и просит свести, сравнить филиалы или найти проблемные позиции. --- # Разбор выгрузки из 1С ## Порядок работы 1. Проверить разделитель и кодировку, показать первые 5 строк. 2. Назвать колонки понятными словами и подтвердить у пользователя. 3. Выбросить служебные строки: итоги, пустые артикулы, дубли. 4. Посчитать то, что просили. Формулы показать словами. 5. Отдать результат таблицей + три вывода обычным языком. ## Чего не делать - Не додумывать пропущенные значения молча — спросить. - Не сводить филиалы в один итог, если об этом не просили. Подробные примеры колонок — в файле [kolonki-1c.md](materialy/kolonki-1c.md).
Никакой установки, компиляции и «запуска». Вы кладёте эту папку в нужное место — и агент начинает вести себя так, как в ней написано, каждый раз, когда задача подходит по описанию.
В официальной спецификации обязательных полей ровно два: name и description. Остальное — расширения конкретных инструментов, и без них скилл прекрасно работает.
name
Имя скилла. Оно же — имя папки. По нему скилл зовут вручную через /.
razbor-vygruzki, а не Разбор Выгрузки;anthropic и claude — они зарезервированы.description
Самое важное поле во всём скилле. По нему агент решает, доставать этот скилл или нет — а значит, от него зависит, будет скилл работать или мёртво лежать в папке.
прочие поля
Разные инструменты добавляют свои: ограничить скиллу набор инструментов, запускать его в отдельном помощнике, разрешить звать только вручную. Это надстройки конкретной программы, а не часть общего стандарта.
description: помогает с даннымиdescription: Разбор выгрузок из 1С… Использовать, когда пользователь присылает CSV или Excel из 1С и просит свести, сравнить филиалы или найти проблемные позиции.Главный инженерный приём скиллов: содержимое подтягивается частями, по мере надобности. Пока скилл не понадобился, он почти ничего не стоит.
В памяти агента с самого начала лежат только имя и описание каждого скилла — короткая строчка, по которой он решает, пригодится скилл или нет.
≈ 100 токенов на скиллЗадача совпала с описанием — только тогда агент открывает SKILL.md целиком и читает порядок действий. До этого момента текст инструкции в разговор не попадает.
Примеры, справочники, шаблоны, схемы колонок — лежат рядом и открываются поштучно, только если инструкция на них сослалась и они реально понадобились в этой задаче.
0, пока не открылиУровень 1 загружается всегда. Сто скиллов — это сто описаний в голове агента при каждом запуске, плюс сто вариантов, из которых он каждый раз выбирает. Расход небольшой, а вот вероятность промахнуться с выбором растёт заметно.
Правило то же, что с наймом людей: скиллов в штате столько, сколько у вас регулярных задач. Не пригодился за месяц — снимаем.
Разница только в том, где скилл виден. Устройство файла везде одинаковое.
Ваш личный набор. Работает в любом проекте, никуда не уезжает, живёт на вашем компьютере. Сюда кладём то, что нужно вам всегда: ваш стиль писем, ваши правила разбора данных.
Лежит внутри папки проекта, уезжает вместе с ней на другой компьютер и к коллеге. Сюда — то, что относится к конкретному делу: правила этого клиента, устройство этой выгрузки.
Когда вы ставите готовый набор одной командой, его скиллы приезжают вместе с ним. В папку скиллов они при этом не попадают — не пугайтесь пустой папки и не ставьте второй раз.
Не садитесь писать файл руками. Сделайте задачу вместе с агентом один раз, а потом скажите: «запомни, как мы это сделали, и оформи скиллом — чтобы дальше ты делал так же сам». Он напишет файл, а вы прочитаете и поправите словами. Так и получается свой первый скилл — из работы, а не из головы.
Ничего из написанного выше не нужно принимать на веру. Всё это — пересказ официальной документации простыми словами; вот сами документы.