У меня в Claude Code живёт скилл для каруселей. Пишу «собери карусель про X» и получаю готовые PNG 1080×1350 в одном из шести фирменных стилей. Про формат, шрифты и число слайдов я больше не объясняю ни слова.

Такие вещи не надо писать с нуля. Самый короткий путь — один раз сделать задачу вместе с Claude, поправить результат и попросить: «упакуй то, что мы сейчас сделали, в скилл».

Ниже — как это устроено и как повторить у себя, без единой строчки кода.

Сначала руками, потом упаковка

Скилл заранее не придумывают. В него упаковывают то, что уже отработало и повторилось.

Официальный skill-creator от Anthropic — плагин, который сам собирает скиллы, — устроен вокруг того же порядка: сначала черновик задачи прогоняется на реальном примере, потом из результата достаётся инструкция. Разработчики так и пишут в его инструкции: если пользователь говорит «сделай из этого скилл» прямо в разговоре, где задача уже решалась, нужно вытащить ответы из истории чата — какие инструменты использовались, в какой последовательности, что пользователь поправил руками, — а не сочинять процесс с чистого листа.

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

Шаг 1. Провести задачу в чате как обычно

Ничего специального. Открываешь чат, ставишь задачу своими словами, как ставил бы человеку. Не думаешь про будущий скилл — думаешь про результат.

Шаг 2. Поправить то, что не понравилось

Здесь самое ценное. Каждая твоя правка — это кусок будущей инструкции. Если ты написал «не такой стиль, возьми вот этот» или «слайдов слишком много, убери два», это правило. Без него Claude повторит ту же ошибку в следующий раз.

Шаг 3. Попросить упаковать

Формулировка простая: «упакуй то, что мы сделали, в скилл» или «сделай из этого скилл на будущее». Claude читает всю историю разговора — задачу, свои шаги, твои правки — и собирает из этого файл SKILL.md.

Файл всегда состоит из двух частей: фронтматтер с именем и описанием, и дальше — сама инструкция в markdown. Вот минимальный шаблон, без реальной задачи, просто чтобы видеть форму:

---
name: имя-скилла
description: Use when пользователь просит X — по теме Y или Z.
  Triggers: "сделай X", "собери X для Y".
---

# Заголовок скилла

Что собирает скилл на выходе, одной строкой.

## Собрать вход
1. Что нужно узнать у пользователя, если не сказал сам
2. ...

## Процесс
1. Шаг
2. Шаг

## Чего не делать
- Типичная ошибка, которую видел на практике

В моих реальных скиллах — например, в том, что собирает карусели для Instagram, — устройство ровно такое: description во фронтматтере отвечает не только «что делает скилл», но и «когда его вызывать», с явным списком триггерных фраз («сделай карусель», «собери карусель про X»). Дальше в теле — пошаговый процесс, который я когда-то проходил руками: собрать вход (тема, фактура, стиль), завести файл, подставить тексты, отрендерить, посмотреть глазами, поправить.

Шаг 4. Проверить описание — от него зависит всё

Это единственное место, где легко ошибиться, и оно решает, вызовется скилл сам или нет. Claude смотрит на список доступных скиллов и решает, консультироваться с каким-то из них, глядя именно на поле description. Тело файла в этот момент ещё не читает.

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

Если ты написал общее описание — «помогает с контентом» — Claude не поймёт, когда именно его открывать, и просто не подгрузит. Если написал слишком узкое — «карусель про кейс клиента X» — скилл не сработает на соседней теме, где на самом деле применим тот же процесс. Описывай то, в чём уверен: конкретные фразы, которыми ты сам обычно формулируешь такую просьбу, и контекст, в котором задача возникает.

Шаг 5. Протестировать на новом входе

Прогон на той же задаче, где скилл родился, ничего не проверяет. Проверка — новый вход того же типа.

Для карусели это значит: попросить собрать карусель на совсем другую тему, не ту, на которой скилл собирался. Если Claude сам вызвал файл без напоминания и прошёл процесс без твоих подсказок — описание рабочее. Если пришлось объяснять заново — правь description, а не тело файла: почти всегда причина в том, что триггерная фраза не совпала с тем, как ты реально формулируешь просьбу.

Где это работает

В Claude.ai скиллы включаются в настройках, в разделе с возможностями — и там же можно загрузить свой скилл. Логика описания та же: пиши только то, что реально повторяется в твоих задачах. Общая формулировка вроде «помогает с текстами» не даст Claude понять, когда открывать файл, — лучше конкретный кейс, даже узкий, чем расплывчатый охват.

В Claude Code скиллы — это папки ~/.claude/skills/<имя>/SKILL.md на диске. Устроены точно так же: фронтматтер с именем и описанием сверху, инструкция ниже, при необходимости — соседние файлы со справочными материалами, которые Claude читает только при обращении к ним, а не грузит в контекст сразу.

Ошибка, в которую легко влететь

Соблазн — упаковывать в скилл вообще всё, что делаешь дважды. У меня в какой-то момент стояло 267 скиллов. По логам вызывались из них 35. Я оставил 39, остальное отправил в архив.

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

Правило простое: скилл заводится под задачу, которая уже повторилась несколько раз и повторится ещё. Не под задачу, которая теоретически может повториться.

Про то, как я собирал систему из 46 разобранных чужих каруселей — до того, как это стало отдельным скиллом, — есть отдельный разбор: как я собрал систему каруселей. А про общий набор из 39 скиллов, который я в итоге оставил после чистки, — в статье один набор скиллов на Claude Code и Codex.