Положите папку скилла в каталог .claude/skills внутри проекта, откройте Claude Code из этого проекта и вызовите скилл командой /имя-скилла. Для проверки дайте ему небольшую задачу и посмотрите, следует ли ответ инструкциям из файла SKILL.md. Ниже разберём, как проверить чужой скилл перед установкой, куда положить файлы и что делать, если команда не находится. Начать лучше с проекта, где нет рабочих данных.
Что проверить до установки чужого скилла?
Скилл — это папка с инструкцией для Claude Code. Обычно главная инструкция лежит в файле SKILL.md; рядом автор может положить шаблоны, примеры или скрипты. Поэтому перед копированием откройте всю папку, а не только описание на странице загрузки. Если скилл предлагает запускать команды, сначала выясните, что именно они меняют.
Для сайта малого бизнеса граница особенно понятна: инструкция «проверь форму заявки и перечисли найденные ошибки» подходит для первого знакомства. Инструкция «исправь всё и опубликуй сайт» уже даёт агенту слишком широкий простор для пробного запуска. Начните с задачи, где Claude только читает файлы и пишет отчёт.
- Откройте SKILL.md и найдите действия, которые скилл просит выполнить без отдельного согласования.
- Просмотрите скрипты и команды рядом с инструкцией. Не запускайте то, чьё действие не можете объяснить.
- Проверьте, не просит ли скилл показать ключи доступа, содержимое служебных файлов или данные из других проектов.
- Выберите для первой проверки копию проекта без рабочих доступов.
Если происхождение папки вызывает вопросы, поможет отдельный разбор о том, как проверить чужой скилл Claude Code перед запуском. Установка занимает меньше времени, чем разбор последствий команды, которая изменила не тот файл.
Куда положить папку скилла в Claude Code?
Для скилла, который нужен только одному сайту, положите его папку в .claude/skills внутри корня проекта. Итоговый путь выглядит так: .claude/skills/имя-скилла/SKILL.md. Корень проекта — папка, из которой вы открываете Claude Code для работы над этим сайтом. Если каталога .claude/skills ещё нет, создайте его.
Для личного скилла, который нужен в разных проектах, используйте ~/.claude/skills/имя-скилла/SKILL.md. Знак ~ обозначает домашнюю папку пользователя. Если за одним компьютером работают разные люди, такой путь относится к тому пользователю, под которым запущен Claude Code.
| Где лежит папка | Когда выбрать | Что проверить |
|---|---|---|
| .claude/skills/имя-скилла/ | Скилл нужен для одного проекта | Claude Code открыт из корня этого проекта |
| ~/.claude/skills/имя-скилла/ | Вы хотите пользоваться скиллом в разных проектах | Папка находится в домашнем каталоге нужного пользователя |
Копируйте папку целиком, сохраняя структуру автора. После распаковки архива проверьте вложенность: SKILL.md должен лежать непосредственно в папке скилла. Если получилось .claude/skills/архив/имя-скилла/SKILL.md, уберите лишнюю папку «архив». Заодно откройте SKILL.md и посмотрите, какое имя указано в его начале: оно пригодится для ручного вызова.
Как проверить, что скилл запускается и выполняет задачу?
Откройте новую сессию Claude Code из корня проекта. Введите /имя-скилла, подставив имя вашего скилла, и дайте ограниченную задачу. Для скилла проверки сайта подойдёт запрос: «Посмотри форму заявки в этом проекте. Ничего не меняй. Назови файлы, которые проверил, и перечисли риски». Так проще отличить работу скилла от обычного ответа Claude.
Перед запуском найдите в SKILL.md узнаваемое правило: например, «сначала перечисли проверенные файлы» или «раздели замечания на ошибки и вопросы». После ответа проверьте, выполнил ли Claude это правило и назвал ли реальные файлы проекта. Один только вежливый ответ со словами «я проверил» запуск скилла не подтверждает.
- Введите команду /имя-скилла и убедитесь, что Claude Code её принимает.
- Попросите выполнить небольшую задачу без изменения файлов.
- Сверьте ответ с конкретным правилом из SKILL.md и с файлами проекта.
- Если скилл должен менять код, разрешите отдельную небольшую правку лишь после этой проверки и просмотрите результат.
На последнем этапе проверяйте и сам сайт. Например, после правки формы откройте страницу, отправьте тестовую заявку, попробуйте пустое обязательное поле и повторное нажатие кнопки. Отчёт агента не заменяет проверку поведения страницы в браузере.
Почему Claude Code не видит скилл?
Начните с пути к файлу. Чаще всего при ручной установке мешает лишний уровень папок, другая рабочая папка проекта или ошибка в имени. Если файлы на месте, откройте новую сессию Claude Code и повторите вызов. Затем сравните имя в SKILL.md с тем, которое вводите после косой черты.
Есть и другой случай: команда принимается, но ответ не следует инструкции. Проверьте, не слишком ли расплывчато написан сам скилл. Формулировка «улучши сайт» не даёт понятного критерия проверки. Формулировка «найди обработчик формы, назови файл и опиши поведение при пустом поле» позволяет сверить ответ с кодом и страницей.
Типичные ошибки
- Скопировали только SKILL.md, хотя инструкция ссылается на соседние файлы. Исправление: восстановите структуру папки и проверьте ссылки внутри инструкции.
- Положили скилл в один проект, а Claude Code открыли из другого. Исправление: перейдите в корень нужного проекта и начните новую сессию.
- Вызвали имя папки, которое не совпадает с именем в SKILL.md. Исправление: сверьте оба имени и повторите команду.
- Проверяли запуск просьбой «сделай что-нибудь полезное». Исправление: задайте ограниченную задачу с признаком из SKILL.md, который можно увидеть в ответе.
Начните с одного скилла и одной задачи без правок: откройте его SKILL.md и найдите правило, по которому сможете узнать работу скилла в ответе Claude Code.
