Недавно я писала, что агентов не обучают, им дают контекст. И одним из трёх слоёв этого контекста назвала навыки, в Claude они называются скиллами. Тогда я объяснила их одной строчкой. Но после этого меня несколько раз спросили: а как это вообще устроено? Где они лежат, как Claude понимает, какой включить, и чем это отличается от обычной длинной инструкции в чате?

Разобралась и записываю для себя и для вас.

11 ноября дополнила статью разбором доклада Мэган Чой, руководителя дизайна Claude Code: она уверяет, что скиллы руками больше никто не пишет. Ниже рассказываю, согласна ли я с ней и что в скилле всё равно остаётся за человеком.

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

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

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

Со скиллом так же. Записали процедуру один раз, и дальше Claude делает её одинаково, без ваших повторных объяснений.

Из чего состоит скилл

Обязательный файл один — SKILL.md. В самом начале у него две строчки служебной информации:

  • name — короткое имя латиницей, например publish-article;
  • description — описание в пару предложений: что скилл делает и когда его использовать.

Ниже идут сами инструкции: шаги, примеры хорошего результата, что делать в сложных случаях. А по желанию в папке рядом лежат:

  • справочные файлы, которые нужны не всегда (например, подробные правила тона);
  • шаблоны, которые Claude копирует и заполняет;
  • скрипты — код для тех шагов, где программа надёжнее текста: проверить контраст цветов, собрать файл, посчитать что-то.

Как Claude понимает, какой скилл включить

Это самое интересное. Claude не читает все скиллы целиком в начале разговора. Он подгружает их по слоям:

  • Сначала только оглавление. Claude видит имя и описание каждого скилла. Это примерно сотня токенов на скилл, поэтому их можно подключить много, и они почти не занимают места.
  • Потом нужный скилл целиком. Когда ваша просьба совпадает с описанием, Claude открывает SKILL.md и читает инструкции.
  • Дополнительные файлы — только по ходу дела. Если в инструкции сказано «для таблиц смотри такой-то файл», Claude откроет его, только когда дойдёт до таблиц. Скрипты он просто запускает, их код в разговор не попадает, только результат.

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

Поэтому в описании стоит писать теми словами, какими вы обычно формулируете задачу. Если я пишу «выложи статью», а в описании только «публикация контента в CMS», Claude может не догадаться, что это про одно и то же.

Если не хочется полагаться на догадку, скилл можно вызвать вручную: в Claude это делается через «/» в поле сообщения.

Чем скилл отличается от других способов дать контекст

Сначала я путалась, куда что класть. Сейчас разложила так:

  • Настройки и инструкции проекта — то, что нужно в каждом разговоре. Например, «отвечай на русском, обращайся ко мне в женском роде». Это читается всегда.
  • Скилл — процедура для конкретной задачи. Читается, только когда задача подходит.
  • Коннекторы — доступ к внешним сервисам и данным: Google Drive, Notion, Figma. Скилл может объяснить, как пользоваться коннектором, но сам до сервиса не достанет.
  • Плагин — коробка, в которую упаковано несколько скиллов вместе с коннекторами и командами, чтобы поставить всё разом.

Простое правило: если вы ловите себя на том, что в третий раз объясняете Claude одно и то же, это кандидат в скилл. Если задача разовая, проще описать её прямо в чате.

Какие скиллы уже есть

Часть скиллов встроена и работает сама. Например, когда вы просите сделать презентацию, таблицу Excel, документ Word или PDF, Claude подгружает готовые скиллы для этих форматов. Поэтому файлы получаются аккуратными, а не «текстом, который надо куда-то вставить».

Ещё есть скиллы от партнёров, скиллы, которые раздаёт компания своим сотрудникам, и ваши собственные. Все они собраны в разделе настроек «Скиллы» (Customize, затем Skills). Там же их включают и выключают.

Отдельно отмечу skill-creator — скилл, который помогает написать другие скиллы. Можно просто попросить Claude: «давай сделаем скилл из того, что мы сейчас делали», и он соберёт черновик вместе с вами, а потом прогонит на тестовых запросах.

Как это выглядит у меня

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

Раньше всё это я каждый раз объясняла заново или копировала из заметок. И каждый раз что-нибудь забывала: то ссылку на Telegram не ту, то проверку после выкладки. Теперь процедура живёт в одном месте, и если что-то меняется, я правлю её там.

Эта статья, кстати, тоже прошла через такой путь: от черновика до страницы на сайте её довёл агент по записанной процедуре.

Скиллы руками больше никто не пишет

Эту фразу сказала Мэган Чой, руководитель дизайна Claude Code в Anthropic, на встрече дизайнеров Dive Club Live в Нью-Йорке. Я узнала о докладе из разбора Сергея Ельпина на Дизайн-кабаке. Мэган показывала свой скилл для прототипов и мимоходом пошутила, что сама его не писала: скиллы сегодня просто заказывают у Claude промптом.

Это шутка, но я в ней узнала себя. Ни один мой скилл я не набирала с нуля. Я рассказываю Claude, как работаю, он оформляет файл, я читаю и правлю. Чтобы не потерять, какой скилл к какой задаче, я завела отдельный документ «Скиллы — CaseSociety»: таблицу «задача — скилл».

Но если файл пишет Claude, что тогда делаю я? Сложность скилла не в формате. Сложность в том, чтобы знать собственный процесс. Чтобы заказать хороший скилл, нужно ответить на вопросы, которые Claude за вас не задаст:

  • Какую работу я повторяю и в каком порядке?
  • Где я обычно ошибаюсь?
  • Как выглядит «хорошо» и как это проверить?

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

Это обычная продуктовая работа: заметить проблему, найти причину и встроить решение в процесс. Claude отлично оформляет вывод, но сам вывод делаю я.

Решение всё равно принимает человек

В докладе есть место, которое для меня важнее шутки про скиллы. Мэган прямо говорит, что Claude, как и большинство языковых моделей, пока не силён в дизайне, поэтому решать, что попадёт в продукт, должна она. А в подкасте Dive Club она добавила: Claude плохо умеет сказать, что ваша идея неверна. Он просто сделает то, о чём попросили.

ИИ сильно сокращает путь от идеи до работающей версии. Но на вопрос «а нужно ли это вообще» он не отвечает.

Я это проверила на себе. Один из своих продуктов я собрала с Claude за несколько дней, выложила страницу и начала развивать. А потом посмотрела трезво, поняла, что продукт сомнительный, и заморозила его. Скорость сборки не заменила проверку гипотезы, она только сделала ошибку дешевле.

Что я забираю себе из доклада Мэган Чой

Приём МэганКак я его применю
Просить несколько вариантов и чтобы Claude сам выбрал один и объяснил почемуСначала выбираю сама, потом сравниваю с его выбором. Расхождение показывает, где он думает не как я, и это потом идёт в скилл.
Скриншот или запись результата в каждой правкеУже делаю: ни одна правка сайта не уходит без превью. Закреплю это в скилле выкладки.
Вопросы к правкам: для кого это, что мы сообщаем, совпадает ли с дизайн-системой, проверены ли текстыСоберу из них скилл-проверку для своих лендингов, чтобы она прогонялась перед каждой выкладкой.
Задача по расписанию, которая сама пишет инженерамНе беру. Мэган сама отключила эти сообщения, потому что вкус у Claude пока не тот.

Что важно помнить

  • Скиллы — это код и инструкции, которые выполняются в вашем разговоре. Чужой скилл перед включением стоит открыть и прочитать, как вы прочитали бы незнакомую программу перед установкой.
  • Не кладите в скилл пароли и ключи. Всем, с кем вы поделитесь скиллом, достанутся все его файлы.
  • Скиллы не синхронизируются между продуктами. Скилл, загруженный в приложение Claude, нужно отдельно добавить в Claude Code или в API.
  • Нужен платный тариф и включённое выполнение кода — скиллы работают в песочнице Claude.
  • Один скилл — одна задача. Несколько маленьких скиллов сочетаются лучше, чем один огромный на всё.

Почему это продуктовая история

Если присмотреться, хороший скилл пишется как хорошая задача для команды. Понятно, когда он нужен. Понятно, что считается готовым результатом. Есть пример. Описаны крайние случаи. Это ровно тот навык, который я считаю главным для продакта и дизайнера в работе с ИИ: умение записать процесс так, чтобы его можно было повторить без вас.

Про то, как я вообще пришла к работе с агентами, я писала в статье «Как я незаметно начала работать с ИИ-агентами», о том, как собирать продукты в Claude Code без программирования, — в отдельной статье, а про то, что будет, когда агентов станет несколько, — в статье про оркестрацию.

Именно такие вещи — как продакту и дизайнеру собирать продукты вместе с ИИ — мы разбираем на Product Builder Marathon. А прогресс и свои эксперименты я выкладываю в Telegram-канале.

А у вас уже есть свой первый скилл? Или пока объясняете Claude одно и то же каждый раз? :)

Частые вопросы

Что такое скилл в Claude?

Это папка с записанной процедурой: главный файл SKILL.md с инструкциями, а рядом при необходимости шаблоны, справочные файлы и скрипты. Claude подгружает скилл, когда задача подходит под его описание.

Как Claude понимает, какой скилл использовать?

В начале разговора он видит только имя и короткое описание каждого скилла. Когда просьба совпадает с описанием, Claude читает инструкции целиком, а дополнительные файлы открывает по ходу работы.

Чем скилл отличается от инструкций проекта?

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

Нужно ли писать скилл вручную?

Нет. Достаточно подробно рассказать Claude, как вы выполняете задачу, и попросить оформить это как скилл. Важнее понимать свой процесс и типичные ошибки, чем формат файла.