Скилл ставится за минуту, и почти все проблемы с установкой сводятся к одному: папка легла не туда, где агент её ищет. Разбираем четыре способа, точные пути для приложения, Claude Code и других агентов, и шесть ошибок, из-за которых «поставил, а не работает».
Что понадобится
- Сам скилл — папка, внутри которой лежит файл
SKILL.md. Где брать готовые — в обзоре источников, как написать свой — в отдельной инструкции. - Понимание, где вы будете им пользоваться. Приложение Клода и Claude Code читают скиллы из разных мест, и скилл, установленный в одном, во втором не появится. Это причина номер один всех неудачных установок.
- Для способов 2–4 — терминал и установленный Node.js.
Ничего собирать и компилировать не нужно: скилл — это текст.
Куда вообще кладётся папка
Таблица, к которой стоит возвращаться. Имя папки должно точно совпадать с полем name внутри SKILL.md.
| Где пользуетесь | Куда класть | Кто увидит |
|---|---|---|
| Приложение Клода (браузер, десктоп, телефон) | загрузка .zip через настройки | только вы |
| Claude Code, личные скиллы | ~/.claude/skills/<имя>/ | вы во всех проектах |
| Claude Code, проектные | .claude/skills/<имя>/ в корне репозитория | все, кто клонирует проект |
| Claude Code, из плагина | приходит вместе с плагином | где плагин включён |
| Codex, Cursor и другие агенты | .agents/skills/<имя>/ | зависит от агента |
Папка .agents/skills — межагентный стандарт, описанный в спецификации Agent Skills. Её понимают Codex, Cursor, Windsurf и ещё несколько десятков инструментов. Claude Code её не читает — и это ровно тот случай, когда скилл лежит на диске, а агент его не видит.
1. Способ первый: положить папку руками
Самый прямой и для одного-двух скиллов самый быстрый.
В Claude Code. Создайте папку и положите в неё файл:
mkdir -p ~/.claude/skills/otchet-po-prodazham
# дальше кладём туда SKILL.mdДля проектного скилла — то же самое, но .claude/skills/ в корне репозитория. Правило разделения простое: личное и с чувствительными деталями — в домашнюю папку, общекомандное — в проект. В репозиторий не должно попасть ничего, что вы не готовы показать всем с доступом.
В приложении Клода. Папку со скиллом упаковывают в .zip и загружают через настройки — раздел со скиллами, кнопка добавления. Архив должен содержать саму папку скилла, а не её содержимое россыпью.
ВажноЗагруженный в приложение скилл виден только вашему аккаунту и не появится в Claude Code на том же компьютере. Это два разных хранилища.
2. Способ второй: команда npx skills
Отдельная утилита, которая скачивает скиллы из репозиториев и раскладывает их по правильным папкам сама. Проект vercel-labs/skills, 31 389 звёзд на GitHub (проверено 11 сентября 2026), поддерживает больше восьмидесяти агентов.
Поставить весь набор из репозитория:
npx skills add coreyhaines31/marketingskills -a claude-codeОтдельные скиллы — перечислением через --skill:
npx skills add coreyhaines31/marketingskills --skill cro copywritingПосмотреть, что вообще есть в репозитории, не устанавливая:
npx skills add coreyhaines31/marketingskills --listПолезные соседние команды: npx skills list — что уже установлено и откуда, npx skills find <слово> — поиск по реестру, npx skills update — обновить установленное, npx skills remove — удалить.
Главная тонкость — флаг -a. Без него утилита сама решает, куда класть, и в неинтерактивном режиме (например, когда вы попросили поставить скиллы самого агента) может положить всё в универсальную .agents/skills, которую Claude Code не читает. Указывайте агента явно.
По умолчанию установка идёт в проект; флаг -g кладёт скиллы глобально.
3. Способ третий: плагин Claude Code
Когда нужен не один скилл, а целый набор, который удобно включать и выключать целиком.
/plugin marketplace add coreyhaines31/marketingskills
/plugin install marketing-skillsПервая команда добавляет источник, вторая ставит из него набор. Скиллы из плагина вызываются с приставкой — /имя-плагина:имя-скилла, — поэтому они не конфликтуют с вашими личными, даже если названия совпали.
Чем плагин отличается от папки со скиллами и что ещё в него кладут — слэш-команды, агентов, хуки, MCP-серверы — разобрано в материале про плагины.
4. Способ четвёртый: клонировать репозиторий
Вариант для случая, когда чужой набор вы собираетесь править под себя и хотите видеть обновления автора.
git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/cro ~/.claude/skills/Или подмодулем, если скиллы нужны команде вместе с проектом:
git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskillsСпособ честный, но ручной: обновление — это git pull и повторное копирование. Если правите чужие скиллы всерьёз, проще сделать форк и клонировать уже его.
5. Проверить, что скилл подключился
Не полагайтесь на то, что файл лежит в правильном месте.
В Claude Code есть прямая проверка:
/skillsОткроется список: какие скиллы доступны, откуда каждый загружен, какие включены. Если вашего в списке нет — дальше можно не проверять, дело в пути или в имени.
Вторая команда, о которой знают реже:
/skill-doctorПоказывает, сколько контекста стоит каждый скилл и какие из них ни разу не сработали. Полезно, когда набор разросся и агент начал ошибаться в выборе.
Боевая проверка одна и та же везде: дайте задачу словами из описания скилла — той самой строки description, по которой агент решает, подключать его или нет. Если правила применились, всё в порядке. Если агент сделал по-своему — скилл либо не подключился, либо описание не совпало с вашей формулировкой.
Шесть ошибок при установке
1. Папка в .agents/skills, а проверяете в Claude Code. Самая частая. Универсальную папку читают Codex и Cursor, Claude Code — нет. Переложите в .claude/skills/ или переустановите с флагом -a claude-code.
2. Имя папки не совпадает с полем name. В спецификации это жёсткое требование: name обязан в точности повторять имя родительской папки. Скачали cro-v2, а внутри name: cro — скилл не подхватится.
3. Лишний уровень вложенности. Распаковали архив и получили ~/.claude/skills/marketingskills/skills/cro/SKILL.md. Агент ищет SKILL.md на первом уровне внутри папки скилла, а не на третьем.
4. Заглавные буквы, пробелы или подчёркивания в имени. Допустимы только строчные латинские буквы, цифры и дефис; дефис не может стоять в начале и в конце, два дефиса подряд запрещены. Otchet_Prodazhi — невалидное имя, otchet-prodazhi — валидное.
5. Поставили в один проект, проверяете в другом. Проектные скиллы видны только внутри своего репозитория. Если скилл нужен везде — его место в ~/.claude/skills/.
6. Скилл написан под Claude Code, а вы ставите его в другой агент. Claude Code умеет подставлять в текст скилла результат команды через специальный синтаксис с обратными кавычками. Остальные агенты этого не понимают и покажут строку как есть — получится мусор посреди инструкции. Если набор заявлен как межагентный, такого в нём быть не должно; если скилл писали под Claude Code — он и останется под Claude Code.
ПолезноЕсли после установки агент стал чаще промахиваться мимо нужного скилла, дело обычно не в конкретной папке, а в их количестве: описания всех доступных скиллов агент читает каждый ход. Разумный рабочий набор — единицы, а не десятки.
Как обновлять и удалять
Установленные через npx skills обновляются командой npx skills update, удаляются через npx skills remove.
Скопированные руками обновляются так же руками: заново скачать и перезаписать папку. Именно поэтому у зрелых наборов есть файл с версиями — например, VERSIONS.md со списком «скилл — версия — дата», по которому видно, что успело измениться с вашей установки.
Плагины — через /plugin: тот же интерфейс, которым ставили.
Свои скиллы версионируйте сами. Поле version внутри metadata в заголовке файла ничего не делает автоматически, но без него через полгода вы не вспомните, правленая у вас версия или исходная.
Коротко о главном
- Установка скилла — это положить папку туда, где агент её ищет. Всё остальное — детали.
- Приложение Клода и Claude Code хранят скиллы раздельно: архив через настройки в первом, папка
.claude/skills/во втором. .agents/skills/— межагентный стандарт для Codex, Cursor и других. Claude Code его не читает.npx skills add … -a claude-codeизбавляет от выбора пути, но без флага агента может положить не туда.- Проверка в Claude Code — команда
/skills; универсальная проверка — дать задачу словами из описания скилла. - Имя папки обязано совпадать с полем
name, только строчные латинские буквы, цифры и дефис.
Дальше: как написать свой скилл — полчаса и текстовый файл; что проверить в чужом скилле до того, как агент начнёт ему следовать.