Как поделиться навыком Claude Code с командой

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

Личный навык и проектный

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

Отсюда первое практическое действие: если навык описывает, как работать именно с этим проектом (структура кода, правила ревью, порядок выкладки), ему место в проекте, а не в вашей личной папке. Перенесите его туда, добавьте в коммит и напишите строчку в описании изменений — этого достаточно.

Что проверить перед раздачей

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

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

Ваши личные пути и настройки. Всё, что ссылается на папку на вашей машине или на ваш локальный конфиг, у других сломается. Пути внутри проекта — относительные.

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

Совет

Когда навыков набирается несколько и они относятся к одной области, раздавать их по одному неудобно: половина команды поставит два из пяти. Для этого есть плагины — пакет навыков, который ставится одним действием и обновляется централизованно. Начинать с плагина не надо, но как только вы второй раз объясняете коллеге, какие три навыка ему нужны, это сигнал упаковать их вместе.

И полезная привычка на будущее: заводите навык не тогда, когда он идеален, а когда вы во второй раз объяснили одно и то же. Как их писать — в статье Skills в Claude Code: свои команды и рабочие процессы.

Где купить Claude

Claude Code работает на платной подписке или на оплаченном API, а картой РФ на сайте Anthropic не заплатить. У нас Claude Pro (2 090 ₽/мес), Max 5x (11 010 ₽/мес), Max 20x (22 010 ₽/мес) и пополнение API от $20: карта РФ или СБП, поддержка на русском.