Перейти к тексту

Claude Code: работа с coding-агентом5. Как направлять агента

Skills пользователя и проекта: где хранить skill

Засчитывается, когда отвечены все вопросы квиза

Зачем это нужно

Вы написали skill для миграций Cadence, и он работает. Через неделю двое коллег снова забыли обновить seed-скрипт, потому что skill лежит только у вас. В другой раз — наоборот: вы занесли в репозиторий свой личный способ формулировать commit-сообщения, и теперь он навязан всей команде.

Обе ошибки — про одно решение: где хранить skill. От места зависит, кто его получит и в каких сессиях он загрузится.

Как это устроено

Два основных уровня

Claude Code ищет skills в нескольких местах. Для повседневной работы важны два:

Уровень Путь Где загружается Кто получает
Личный ~/.claude/skills/<skill-name>/SKILL.md Во всех ваших проектах на этой машине Только вы
Проект .claude/skills/<skill-name>/SKILL.md В сессиях этого репозитория Все, кто склонировал репозиторий

Имя папки становится командой: skill в .claude/skills/database-migrations/ вызывается как /database-migrations, если name во frontmatter не задаёт другое.

Кроме этих двух бывают skills организации (через managed settings), skills из плагинов и вложенные skills в <subdir>/.claude/skills/ для монорепозиториев. Последние загружаются, когда агент начинает работать с файлами этой поддиректории.

Чем отличаются уровни

Личный skill:

  • Только ваш. Его никто не видит, и никто не обязан им пользоваться.
  • Глобальный. Установили один раз — и он есть в каждом проекте на машине без настройки и копирования.

Skill проекта:

  • В репозитории. Он в истории git, его видно на code review, он меняется вместе с кодом.
  • В одном проекте. В следующий проект он сам не переедет, и это правильно.
  • Общий. Любой участник может его улучшить, и улучшение получат все.

Как выбрать

Правило простое. Если skill — про вас (ваш стиль работы, ваш личный шорткат), кладите его в ~/.claude/skills/. Если он описывает, как устроена работа в этом проекте, и команда на него полагается — в .claude/skills/ репозитория. Когда сомневаетесь и речь о работе, а не о вас, выбирайте проект: никому не придётся ничего устанавливать, и skill не разойдётся с кодом.

Работаете в основном в одиночку — личные skills удобнее, потому что следуют за вами. Как только в проекте больше одного человека, skills проекта окупаются для всех.

Одноимённые skills

Если skill с одним именем лежит и в ~/.claude/skills/, и в .claude/skills/ проекта, /name запустит личный: порядок приоритета — организация, затем личный, затем проект. Это удобно для экспериментов и опасно для команды: у вас skill ведёт себя иначе, чем у коллег.

Практика

Наберите /skills и посмотрите, откуда пришёл каждый skill в списке. Если в списке есть skill с тем же именем, что и в .claude/skills/ проекта, проверьте, какой из них ваш. Затем создайте пустую папку для пробы:

mkdir -p .claude/skills/hello-project

Положите в неё SKILL.md с одной строкой description и коротким телом. Claude Code отслеживает изменения в .claude/skills/ и подхватывает новый skill в текущей сессии без перезапуска — снова откройте /skills и найдите его. Удалите папку, когда закончите.

Подводные камни

  • Облачные сессии не видят вашу машину. Cowork, облачные сессии и облачные задачи по расписанию не читают ~/.claude/skills/ с вашего компьютера. Если skill нужен там, закоммитьте его в .claude/skills/ репозитория или включите в аккаунте claude.ai.
  • Личная копия перекрывает командную. Оставили у себя старую версию skill с тем же именем — и правки команды в репозитории до вас не дойдут.

Вывод: что про вас — в ~/.claude/skills/, что про проект — в .claude/skills/ репозитория; при сомнении выбирайте проект.

Проверь себя

Источники

Текст подготовлен с помощью LLM и может содержать неточности.