Скиллы Claude Code: что это и зачем они нужны

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

Если вы хоть раз объясняли помощнику одно и то же во второй раз, скилл нужен именно вам.

Что это на самом деле

Скилл это папка с текстовым файлом. В файле написано, как делать определённую работу: с чего начать, что спросить у человека, в каком порядке действовать, чего не делать никогда.

Никакого кода внутри нет. Обычный текст, написанный так, будто вы оставляете инструкцию сотруднику, который придёт вместо вас.

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

Зачем это нужно на практике

Разница видна на второй неделе работы.

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

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

Как помощник выбирает нужный

По описанию в начале файла. Там указано, для каких задач скилл предназначен и какими словами люди обычно эти задачи формулируют.

Отсюда практический вывод, который экономит много времени: описание важнее самой инструкции. Скилл с гениальным содержанием и расплывчатым описанием не подхватится никогда, потому что помощник не поймёт, что пора его открыть.

Хорошее описание перечисляет живые формулировки: не «работа с аналитикой», а «собери отчёт», «посчитай конверсию», «что изменилось за неделю».

Чем скилл отличается от соседних понятий

Здесь легко запутаться, потому что четыре разные вещи называются похоже.

Скилл это знание о том, как делать работу. Текст с порядком действий.

MCP или коннектор это доступ к данным: к почте, календарю, таблицам, задачам. Не знание, а дверь.

Плагин это набор скиллов, упакованный вместе, чтобы поставить их одним действием, а не по одному.

Файл правил проекта это то, что действует всегда, независимо от задачи: как обращаться к вам, каких слов не употреблять, на каком языке отвечать.

Разница между первым и вторым важна практически: если помощник не умеет достать данные, скилл не поможет, нужен MCP. Если данные он видит, но делает работу не так, как вам надо, нужен скилл.

Что чинить, когда результат не тот

Не хватает доступа

1. Помощник отвечает, что не видит нужного
2. Или берёт данные из головы
3. Подключаете MCP к нужному сервису
4. Проверяете, что он действительно видит источник

Чего стоит

Вы открываете помощнику дверь в рабочий сервис. Права выдаются осознанно.

Ваш вариант, если

Ответ неверный, потому что данных у него не было.

Не хватает инструкции

1. Данные он видит и отвечает по делу
2. Но делает не так, как вы привыкли
3. Пишете скилл с порядком работы
4. Проверяете, что он подхватывается по вашей формулировке

Чего стоит

Вечер на первый скилл. Дальше он работает сам и не требует внимания.

Ваш вариант, если

Ответ верный, но каждый раз приходится объяснять формат заново.

Как выглядит свой первый скилл

Начинать стоит не с чего-то большого, а с той работы, которую вы делаете регулярно и одинаково.

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

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

Чего скилл не сделает

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

И он не заменит доступ к данным. Инструкция «посмотри в таблице расходов» без подключённой таблицы останется инструкцией в пустоту.

Поэтому порядок при настройке такой: сначала открыть помощнику доступ к тому, с чем он должен работать, и только потом объяснять, как именно работать. В обратную сторону получается инструкция без предмета.