Как поставить скилл в Claude Code

Скилл для Claude Code — это папка с файлом SKILL.md, где рядом могут лежать скрипты и справочники автора. В начале SKILL.md стоят имя и описание. По описанию агент сам решает, когда открыть скилл, например перед разбором PDF, вычиткой статьи или ревью кода. MCP-сервер устроен иначе. Агент запускает его как отдельную программу и через нее работает с базой, браузером или CRM. Подробнее в нашей инструкции по MCP.

Куда Claude Code смотрит за скиллами

По документации Claude Code личные скиллы лежат в ~/.claude/skills/<имя>/SKILL.md и работают во всех ваших проектах. Скиллы проекта лежат в .claude/skills/<имя>/SKILL.md внутри репозитория. Их стоит закоммитить, тогда команда получит те же скиллы. Если скилл с одним именем есть в обоих местах, Claude Code выбирает личный. Скиллы из плагинов вызываются как /плагин:скилл.

Способ 1. Командой SkillFoxx

Установщик SkillFoxx сам кладет файлы в нужную папку и ведет список установленного. Нужен Node.js 18.18 или новее, ставить CLI заранее не требуется. Например, так ставится скилл Humanizer в текущий проект:

npx skillfoxx add skills/humanizer --agent claude-code

CLI сначала скачивает подписанный рецепт со skillfoxx.ru, берет файлы скилла с GitHub на зафиксированном коммите и сверяет их хеши. Затем он кладет папку в .agents/skills/humanizer и ставит на нее символическую ссылку из .claude/skills/humanizer. Мы проверили это 30 сентября 2026 года на версии CLI 0.3.0. Флаг --global ставит скилл для пользователя, в ~/.agents/skills. Флаг --dry-run только покажет план.

Список установленного CLI записывает в skillfoxx-lock.json в корне проекта: коммит, хеш файлов, уровень риска и пути. Этот файл тоже стоит закоммитить.

Способ 2. Вручную

Ручной путь нужен, когда скилла нет в каталоге или вы правите свой скилл по ходу работы. Репозиторий скачивают, находят папку со SKILL.md и копируют ее целиком:

git clone https://github.com/blader/humanizer /tmp/humanizer && mkdir -p ~/.claude/skills && cp -R /tmp/humanizer ~/.claude/skills/humanizer

По спецификации Agent Skills имя папки совпадает с полем name в SKILL.md, из него Claude Code берет команду для вызова. Скопировать нужно всю папку: скрипты и справочники рядом со SKILL.md агент открывает по ссылкам из текста. В репозитории Humanizer рядом со SKILL.md лежит папка scripts с проверочным скриптом на Python.

Способ 3. Плагином из маркетплейса

Часть авторов публикует скиллы как плагин Claude Code. Тогда команды вводят в чате агента. Для Humanizer это две строки:

/plugin marketplace add blader/humanizer

/plugin install humanizer@humanizer

Первая команда подключает маркетплейс автора, вторая ставит плагин. Команды для других плагинов есть на карточках в разделе плагинов, там 282 записи. Установщик SkillFoxx плагины сам не ставит. Он печатает эти две команды, а вводите их вы.

Как проверить, что скилл работает

Claude Code отслеживает папки скиллов и подхватывает новый скилл в текущей сессии. Если папки ~/.claude/skills или .claude/skills при запуске сессии еще не было, Claude Code за ней не следит, и тогда нужна команда /reload-skills. Команда /skills в чате покажет список, и имя нового скилла будет в нем. Вызвать его можно двумя путями. Командой /humanizer вы запускаете скилл явно. Просьба, похожая на описание («убери из этого абзаца приметы ИИ»), запускает его автоматически.

Если агент игнорирует скилл, откройте SKILL.md и перечитайте поле description. Claude Code держит в контексте только описания скиллов, а в списке обрезает описание вместе с полем when_to_use до 1536 символов. Размытое «помогает с текстом» агент с задачей не свяжет.

Что может пойти не так

• Скилла нет в /skills. Папка лежит на уровень глубже, чем нужно, например .claude/skills/humanizer/humanizer/SKILL.md. Поднимите ее на уровень выше.
• Скилл запускается, но падает на шаге со скриптом. В системе нет нужной программы, чаще всего Python 3 или Node.js. Список требований автор пишет в README, мы переносим его в раздел ограничений на карточке.
• Скилл просит ключ API. Переменную окружения с именем из README нужно задать и перезапустить терминал.
• После ручного обновления CLI сообщает об изменениях. Команда npx skillfoxx doctor находит файлы, которые правили руками, а npx skillfoxx update ставит версию, сверенную с репозиторием.

Права и безопасность

Скилл получает те же права, что и Claude Code в вашей сессии. Скрипты скилла он запускает на вашем компьютере. Поэтому уровень риска стоит на каждой карточке каталога. На 30 сентября 2026 года из 695 скиллов в каталоге у 244 низкий риск, у 339 средний, у 112 высокий. Низкий риск мы ставим скиллам из одних инструкций и справочников, средний — тем, что запускают код, ходят в сеть или читают файлы проекта. Высокий получают скиллы, которые пишут во внешние системы или работают с секретами и деньгами.

Со средним риском CLI печатает причины перед установкой. С высоким он спрашивает согласие, а без терминала и флага --yes останавливается. Начинайте со скиллов низкого риска и ставьте их в один проект без флага --global. Перед установкой незнакомого скилла прочитайте его SKILL.md и скрипты, порядок проверки описан в статье как проверить скилл на безопасность.

Где найти скиллы

В разделе скиллов каталога 695 записей, у каждой есть команда установки, уровень риска с причинами, способ удаления и ограничения вроде нужной версии Python или платного ключа API. Если не знаете, что искать, опишите проект в подборе с Foxx AI: он предложит скиллы из каталога под ваши файлы и задачу.