Claude Code - единственная среда Claude, которая действительно устанавливает Skills с диска, поэтому советы для неё отличаются от всего, что написано о Custom Instructions. Это практическое руководство: как устроена папка, какие Skills стоит сохранять и на что люди зря тратят время.
Как работают Skills в Claude Code
Skills находятся в каталоге .claude/skills/. Каждый Skill представляет собой вложенную папку с файлом SKILL.md внутри. Важны два расположения:
-
Проектные -
.claude/skills/внутри репозитория. Skill хранится вместе с кодом, поэтому он доступен всей команде. Здесь должны находиться всё, что относится к конкретному проекту. - Личные - тот же путь в вашем домашнем каталоге. Применяются ко всему, над чем вы работаете. Здесь должны находиться ваши собственные привычки.
В отличие от Custom Instructions, где одновременно хранится только один набор инструкций, Claude Code может хранить множество Skills и подключать тот, который соответствует вашей текущей задаче. Это меняет представление о хорошем Skill: его описание должно быть достаточно точным, чтобы выбирался нужный Skill, и достаточно узким, чтобы он не выбирался для всего подряд.
Что действительно оправдывает место Skill
После создания множества таких файлов закономерность становится очевидной. Хорошие Skills фиксируют решения, а не информацию.
Skill, в котором объясняется, что такое REST API, напрасно расходует токены на то, что модель и так знает. А Skill, в котором сказано: «в этом репозитории каждая конечная точка возвращает ошибки в формате RFC 7807, а три места, где это не так, являются устаревшими и не должны использоваться как образец», стоит хранить всегда, потому что это решение, которое модель не может вывести самостоятельно.
Проверка проста: если компетентному инженеру, который присоединяется к вашей команде, это пришлось бы объяснить, добавьте это в Skill. Если он и так должен это знать, не добавляйте.
Категории, которые стоит иметь
Проверка кода по внутренним стандартам
Общие комментарии при проверке кода - это информационный шум. Skill для проверки, содержащий реальные соглашения вашей команды, то, о чём вы спорили и по чему пришли к решению, превращает проверку из выражения мнения в контрольный список.
Соглашения по тестированию
Какой фреймворк используется, как называются тесты, что нужно имитировать, а что никогда не следует имитировать, и какой уровень покрытия считается достаточным для этой кодовой базы. Без этого вы получите тесты в стиле, который чаще всего встречался в обучающих данных.
Отладка и работа с инцидентами
Где находятся логи, какая панель отвечает на какой вопрос, какие четыре вещи нужно проверить до эскалации. Этот Skill окупается в три часа ночи.
Инфраструктура и развёртывание
Порядок развёртывания, что безопасно выполнять в рабочей среде, а что нельзя, какие миграции требуют окна обслуживания. Смысл как раз в том, чтобы зафиксировать опасные моменты.
Документация и технические тексты
Где хранится документация, какой структуре следует страница, чем в вашем внутреннем стиле отличаются учебное руководство и справочная документация.
Что следует пропустить
Учебники по языкам программирования. Skill, объясняющий Claude синтаксис Python, - это Skill, объясняющий синтаксис Python тому, кто уже знает синтаксис Python.
Огромные Skills на все случаи жизни. Skill, охватывающий фронтенд, бэкенд, тестирование и развёртывание, будет постоянно загружаться и почти всегда окажется неуместным. Разделяйте его.
Всё, что устареет через месяц. Номера версий, текущие цели спринта, имя дежурного сотрудника. Skills предназначены для долгосрочных решений.
Расплывчатые описания. Если в описании не указано чётко, когда применяется Skill, он либо никогда не будет выбран, либо будет выбираться всегда. И то и другое бесполезно.
Начинайте с шаблона, а не с чистой страницы
Самое сложное - не идея, а форма: насколько конкретным быть, что опустить и как написать описание, чтобы выбор работал. Именно эту часть стоит скопировать из уже проверенного примера.
Мы публикуем ролевые файлы Skills для разработчиков, DevOps-инженеров и архитекторов. Они написаны в виде обычных файлов .md и подходят как для использования в качестве Skill Claude Code, так и для вставки в Custom Instructions:
Skills для Claude Code →
Skills для разработчиков →
Skills для DevOps →
Skills для архитекторов →
Если вы не используете Claude Code и всё же попали сюда, эквивалентом для Claude в веб-версии будут Custom Instructions.
KissMySkills - независимый маркетплейс, не связанный с Anthropic, OpenAI или какой-либо другой компанией в сфере AI, не одобренный ими и не аффилированный с ними. Claude Code - продукт Anthropic.
