Скилл для Claude: как переписать старый под новые модели

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

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

Что изменилось: от «жёсткой инструкции» к скиллу для умной модели

Скиллы перестали быть частной функцией одного продукта. В декабре 2025 года Anthropic опубликовала открытую спецификацию Agent Skills с образцом SDK, а Microsoft начала встраивать этот формат в VS Code и GitHub. Поэтому хорошо написанный скилл теперь — переносимый актив, и вкладываться в его качество есть смысл.

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

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

Главное: рабочий скилл сегодня — не стена правил «на всякий случай», а короткое объяснение, зачем и как делать работу, с точным описанием. Тяжёлые детали лежат в отдельных файлах. То, что нарушать нельзя, отдано скрипту или хуку.

Как Claude читает скилл: три уровня загрузки

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

На первом уровне Claude видит только имя и описание каждого установленного скилла — они попадают в системный промпт. Тело он ещё не читал. Поэтому решение, включать скилл или нет, принимается по нескольким строкам описания.

На третьем уровне у скриптов есть важная особенность: Claude может запустить скрипт из скилла, не загружая его код в контекст. Код детерминирован, так что результат воспроизводится от запуска к запуску. Это пригодится, когда дойдёт до дорогих ошибок.

Сколько скилл стоит в контексте

Скилл расходует контекст дважды. Первый расход постоянный: список имён и описаний всех установленных скиллов занимает до 1% контекстного окна (данные на июль 2026 года). Он висит в любой сессии — даже там, где скилл не нужен.

Второй расход начинается при вызове. Тело SKILL.md загружается и живёт в контексте до конца сессии. По сути, каждая лишняя строка — не разовая трата, а нагрузка на весь оставшийся диалог.

Третий момент касается длинных сессий. Когда контекст заполняется и сессия автоматически сжимается, скиллы возвращаются урезанными: от каждого остаются первые 5 000 токенов, а на все вместе — не больше 25 000 (на июль 2026 года). Скиллы, вызванные давно, могут выпасть полностью.

Ориентиры по длине: Anthropic советует держать SKILL.md в пределах 500 строк, а CLAUDE.md — в пределах 200 строк, перенося специальные инструкции в скиллы, которые грузятся по требованию. Подробности, нужные не в каждом запуске, выносите в отдельные файлы третьего уровня.

Расход скиллов в Claude Code измерить просто: команда /context показывает, сколько окна сейчас заняли скиллы, а /doctor оценивает стоимость их списка. Несколько десятков скиллов сразу не держите. Помимо расхода, это может путать модель.

Описание скилла для Claude решает, сработает ли он

Claude выбирает скилл по имени и описанию. Им и стоит уделить больше всего внимания: с расплывчатым описанием скилл не включится тогда, когда нужен, каким бы хорошим ни было тело.

Хорошее описание отвечает на два вопроса: что делает скилл и в каких запросах его запускать. Пишут его в третьем лице: описание читает модель, которая выбирает инструмент, а не исполнитель, которому отдают приказ. Допустим, скилл делает обложки: «Создаёт обложки для видео. Используется, когда просят обложку или превью».

Длина тоже ограничена. На июль 2026 года описание вместе с полем when_to_use обрезается до 1 536 символов. Если общий список скиллов не помещается в отведённый объём, первыми урезают описания тех, что вызываются редко. Длинное описание с ключевыми словами в конце рискует потерять как раз эти слова.

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

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

Тело скилла: причины вместо капса, свобода по цене ошибки

Самая частая привычка при написании скилла для Claude по старым гайдам — запреты заглавными буквами: «НИКОГДА», «ВСЕГДА». Именно они создают ту жёсткость, которая мешает новым моделям. Лучше работает объяснение причины.

Сравните два варианта. Было: «НИКОГДА не пиши длинные абзацы». Стало: «Пиши абзацы до трёх-четырёх предложений: текст читают с телефона». Во втором случае модель знает цель и применит правило разумно — в том числе там, где буквальный запрет не подошёл бы.

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

Третий вопрос — сколько свободы давать. Все зависит от цены ошибки:

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

Скрипт выполняется одинаково каждый раз, а Claude может запустить его, не загружая код в контекст. Так скилл выходит надёжнее и легче.

Что нельзя доверить скиллу: хуки Claude Code и безопасность

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

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

Вторая граница — доверие к чужим скиллам. Инструкции и скрипты внутри скилла расширяют то, что умеет Claude, а значит, могут принести и проблемы.

Ключевые термины

• Прогрессивное раскрытие — Принцип, при котором Claude загружает скилл по уровням: сначала только описание, затем тело SKILL.md, а дополнительные файлы — лишь при необходимости.
• Фронтматтер — Блок метаданных в начале SKILL.md между строками из трёх дефисов с обязательными полями name и description.
• Листинг скиллов — Постоянно находящийся в контексте список имён и описаний всех установленных скиллов, по которому Claude решает, какой из них включить.
• Автокомпакция — Автоматическое сжатие длинной сессии в краткое резюме, после которого скиллы возвращаются в контекст в урезанном виде.
• Хук — Проверка или команда, которую Claude Code запускает сам в заданный момент, например перед сохранением файла.
• Контекстное окно — Рабочая память модели, в которую помещаются инструкции, скиллы, файлы и диалог; переполнение снижает качество работы.

Итог: чек-лист пересмотра старого скилла

Старый скилл не обязательно переписывать с нуля. Чаще достаточно пройтись по нему и поправить несколько мест.

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

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

Проверьте себя

1. В скилле написано «НИКОГДА не пиши длинные абзацы». Как переписать это правило лучше всего для новой модели?

• А. «Пиши абзацы до трёх-четырёх предложений: текст читают с телефона»
• Б. Удалить правило совсем — новые модели сами всё знают
• В. Добавить ещё больше восклицательных знаков, чтобы модель точно не нарушила правило

2. Ваш скилл занимает 9 000 токенов, а самое важное правило стоит в самом конце. Что произойдёт после автоматического сжатия длинной сессии?

• А. Сохранятся только первые 5 000 токенов, и правило в конце может потеряться
• Б. Claude перечитает файлы из references вместо тела скилла
• В. Ничего: скилл всегда хранится целиком

3. Скилл не включается, когда вы просите «сделай превью для ролика». Что поправить в первую очередь?

• А. Перенести инструкции в отдельный файл references
• Б. Добавить больше примеров в конец тела SKILL.md
• В. Описание: что делает скилл и в каких запросах его вызывать

4. Правило «перед сохранением файла всегда прогонять линтер» нельзя нарушать ни при каких условиях. Где его надёжнее всего закрепить?

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

5. Какие части скилла имеет смысл вынести из SKILL.md в отдельные файлы? (Верных ответов несколько.)

• А. Подробную статистику и примеры, которые нужны не в каждом запуске
• Б. Описание скилла
• В. Инструкции для редкого сценария, например заполнения форм
• Г. Самое важное правило, которое нужно в каждом запуске