Скиллы Claude Code: как научить агента вашим правилам
Если вы объясняете агенту одно и то же третий раз — пора не объяснять, а записать. Разбираю, как устроены скиллы и правила, чем они отличаются и как написать такой, которым вы реально будете пользоваться.
- Скилл — записанная процедура, которую агент подхватывает сам, когда задача подходит под описание.
- Правила — про контекст («где я»), скиллы — про процесс («как это делается»). Смешивать их дорого: файл правил разрастается и читается перед каждой мелочью.
- Описание важнее тела: если в нём нет ваших реальных формулировок, скилл не подключится никогда.
- Работают только проверяемые требования. «Пиши коротко» агент выполнить не может, «абзац не длиннее четырёх строк» — может.
Содержание статьи
Скилл в Claude Code — это записанная инструкция, которую агент сам подхватывает, когда задача под неё подходит. Вы один раз описываете, как у вас принято делать определённую работу, и дальше не повторяете это в каждом сообщении.
Это самая недооценённая часть инструмента. Люди месяцами объясняют одно и то же в чате, хотя стоило потратить двадцать минут и записать.
Три уровня памяти агента
Чтобы не путаться, разложу по слоям. У агента три разных способа знать о ваших требованиях.
| Слой | Когда читается | Что туда пишут |
|---|---|---|
| Глобальные правила | всегда, во всех проектах | как с вами общаться, общие принципы работы |
| Правила проекта | всегда, в этом проекте | стек, структура папок, деплой, что не трогать |
| Скилл | когда задача подходит | процедура: как делать конкретный вид работы |
Ошибка новичка — писать всё в правила проекта. Файл разрастается, агент читает его целиком каждый раз, полезное тонет. Правила должны отвечать на вопрос «где я и что здесь нельзя». Всё, что отвечает на вопрос «как делать эту работу», — в скилл.
Как я это понял
Мой файл правил в одном проекте разросся до нескольких экранов: там были и структура проекта, и требования к текстам, и порядок деплоя, и стиль обложек. Агент читал всё это перед каждой задачей, включая правку одной строчки в конфиге. Когда я разнёс это на короткие правила и четыре скилла, качество выросло, а расход контекста упал: перед мелкой задачей больше не грузится инструкция по написанию статей.
Скиллы, которые у меня работают каждый день
Выкладываю рабочие сетапы и промпты по мере обкатки — вместе с тем, что из этого оказалось лишним.
Как устроен скилл
Технически это папка с файлом инструкции. В начале файла — название и описание, по которому агент понимает, когда скилл применять. Дальше — сама процедура.
Вот как выглядит реальная папка одного из моих скиллов — того, который проводит разведку ниши перед сборкой сайта:
~/.claude/skills/razvedka-nishi/
├── SKILL.md ← имя, описание с триггерами и сама процедура
├── references/ ← то, что грузится только когда понадобилось
│ ├── 01-method.md
│ ├── 04-demand-wordstat.md
│ ├── 06-monetization-rf.md
│ └── 07-ymyl-legal-rf.md
└── assets/ ← шаблоны отчётовСмысл разделения на SKILL.md и references/ — экономия внимания агента: в момент выбора он читает только описание, а тяжёлые справочники подтягивает, когда до них дошёл шаг процедуры.
Описание — самая важная часть. По нему принимается решение, подключать скилл или нет. Плохое описание: «помогает с текстами». Хорошее: «использовать при написании статьи для блога, редактуре текста, проверке на инфостиль; триггеры — "напиши статью", "отредактируй", "проверь текст"».
Дальше в теле полезно держать четыре блока:
- Когда применять и когда не применять. Второе не менее важно.
- Порядок шагов. Пронумерованный, без «и так далее».
- Проверяемые требования. Числа, а не эпитеты.
- Типичные ошибки. То, на чём вы уже обжигались.
Что стоит записать в скилл первым
Смотрите не на чужие списки, а на свою историю. Признак очевидный: вы объясняете одно и то же третий раз.
У меня первыми появились такие:
- Требования к тексту. Голос, запрещённые обороты, длина абзаца, обязательные элементы структуры. Без этого агент пишет вежливый корпоративный текст, который никто не дочитывает.
- Разбор ниши перед запуском сайта. Порядок проверок: спрос, конкуренты, чем закрывается запрос, где деньги. Раньше каждый раз собирал заново.
- Сборка обложек. Формат, палитра, что нельзя рисовать.
- Приёмка страницы. Что проверить перед публикацией: заголовок, описание, микроразметка, внутренние ссылки, скорость.
Как написать свой скилл за двадцать минут
- Возьмите задачу, которую делали минимум трижды.
- Выпишите шаги так, как объясняли бы человеку в первый рабочий день.
- Замените все оценочные слова на проверяемые: не «коротко», а «не длиннее четырёх строк».
- Добавьте раздел «частые ошибки» — по памяти, из своих же переделок.
- Напишите описание с триггерами: по каким словам его подключать.
- Проверьте на живой задаче и допишите то, что агент всё равно сделал не так.
Помоги превратить мой процесс в скилл. Не пиши его сразу — сначала вытащи
из меня то, что я делаю на автомате.
Шаг 1. Задай мне 7–10 вопросов про эту работу: с чего начинаю, какие шаги
всегда одинаковые, что проверяю в конце, на чём обжигался, что считаю
неприемлемым результатом. Спрашивай по одному, дожидайся ответа.
Шаг 2. По моим ответам собери скилл со структурой:
— имя и описание с триггерами (используй мои формулировки, а не свои);
— когда применять и когда НЕ применять;
— пронумерованный порядок шагов, без «и так далее»;
— проверяемые требования (числа вместо оценок);
— типичные ошибки из моих ответов.
Шаг 3. Покажи, какие мои формулировки ты заменил на измеримые, и спроси
подтверждение по каждой спорной.
Правило: ничего не добавляй от себя. Если в моих ответах чего-то нет —
задай вопрос, а не придумывай «best practice».Почему скиллы не работают
Три причины, и все встречаются постоянно.
Расплывчатые формулировки. «Пиши интересно», «сделай красиво», «соблюдай стиль». Агент не может это проверить, а значит не выполнит. Всё, что нельзя проверить, замените на измеримое.
Описание не срабатывает. Скилл написан, но агент его не подхватывает, потому что в описании нет слов, которыми вы реально формулируете задачи. Посмотрите на свои последние сообщения и внесите оттуда формулировки.
Скилл описывает не ваш процесс. Взяли чужой готовый, не переписали. Получили работу по чужому стандарту и решили, что скиллы бесполезны.
Проверка, что скилл живой
Раз в месяц смотрите, что вы правили руками после агента. Если одна и та же правка повторяется — её нет в скилле. Если скилл не подключался ни разу за месяц — либо задача не возникает, либо описание не ловит формулировки. И то и другое чинится за пять минут.
Скиллы, правила и MCP: как собрать вместе
Три части закрывают разные вопросы, и путать их дорого:
- Правила отвечают на вопрос «где я» — контекст проекта.
- Скиллы отвечают на вопрос «как это делается» — процедура.
- MCP-серверы отвечают на вопрос «чем это делать» — доступ к данным и сервисам.
Полный контур выглядит так: агент знает структуру проекта (правила), умеет собирать статью по вашему стандарту (скилл) и может посмотреть реальные поисковые запросы (MCP). Каждая часть по отдельности даёт мало, вместе — заметный скачок.
Читайте такжеMCP-сервер: что этоЭто разъём, через который агент подключается к вашим данным и сервисам: базе, таблицам, аналитике, браузеру. Разбираю, как устроен протокол, что подключать в первую очередь и почему половина MCP-серверов вам не нужна.Отдельный уровень — когда всё это складывается в личную систему знаний, которую агент читает в каждом проекте. Как я это устроил, разбираю в статье про второй мозг.
Если вы ещё не поставили инструмент, начните отсюда: установка Claude Code.
- Признак, что пора писать скилл: вы объясняете одно и то же третий раз.
- В описание вставляйте формулировки из своих же последних сообщений — по ним агент решает, подключаться ли.
- Все оценочные слова замените числами: длина, количество, обязательные элементы.
- Раз в месяц смотрите, что правите руками после агента: повторяющаяся правка = дырка в скилле.
- Чужой скилл берите как структуру, а не как готовый стандарт — иначе получите чужой процесс.
Гайд «6 проектов в Claude Code»
Карусели, Reels, клон-голос, авто-монтаж, второй мозг — с промптами и командами. Бесплатно, отдаёт бот в Telegram.
Частые вопросы
Чем скилл отличается от правил проекта?
Правила проекта агент читает всегда: стек, структура, что нельзя трогать. Скилл подхватывается только когда задача подходит под его описание. Правила — про контекст, скиллы — про процедуры.
Где хранятся скиллы?
В папке скиллов внутри проекта или в глобальной пользовательской папке. Проектные едут вместе с репозиторием и работают у всех, кто его открыл. Глобальные — только у вас, зато во всех проектах.
Насколько подробным должен быть скилл?
Настолько, чтобы человек с улицы выполнил задачу без вопросов. Общие формулировки вроде «пиши хорошо» не работают. Работают проверяемые: «абзац не длиннее четырёх строк», «в каждой статье минимум две внутренние ссылки».
Скиллы экономят токены?
Косвенно. Прямая экономия в том, что вы не пересказываете требования каждый раз. Большая экономия — в отсутствии переделок: агент с первого раза делает по стандарту, а не после трёх кругов правок.
Можно ли брать чужие готовые скиллы?
Можно, и это хороший способ увидеть структуру. Но чужой скилл описывает чужой процесс. Ценность появляется, когда вы переписываете его под свои требования — иначе получите работу по стандарту, который вам не подходит.
10 лет в маркетинге и онлайн-образовании. Запускаю проекты в одиночку на Claude Code и показываю экономику как есть. Все методы из блога сначала обкатываю на своих проектах и только потом описываю.