Как установить скилл в Claude Code?
Коротко: Готовый скилл - это папка с файлом SKILL.md. Её кладут в ~/.claude/skills/, чтобы скилл работал во всех проектах, или в .claude/skills/ внутри одного проекта. Из GitHub копируют нужную папку туда же, а скилл, упакованный в плагин, ставят командой /plugin install. Потом набирают /skills и ищут его в списке.
Если совсем коротко, как установить скилл в Claude Code: положить папку скилла туда, где агент их ищет. Ниже - откуда эта папка берётся и как убедиться, что агент её нашёл.
Открытый скилл из набора Anthropic можно скопировать бесплатно. Это не покупка ClaudeBase. Для работы скилла нужен доступ к самому Claude Code; условия доступа к агенту и внешним API проверяются отдельно.
В моих рабочих проектах сейчас несколько десятков скиллов, код при этом я руками не пишу. «Клод код» и «клауд код» из поиска - это тот же агент, справка о нём есть в отдельной статье, а о самом слове «скилл» - в разборе скиллов.
Пути, имя команды и обновление списка сверены с официальной документацией Anthropic 24 октября 2026 года. Адреса docs.anthropic.com и docs.claude.com перенаправляют на code.claude.com. На macOS с Claude Code 2.1.309 проверены копирование учебной папки и синтаксис YAML на контрольных файлах. Обнаружение в запущенном агенте, вызов скилла моделью и установка на Windows не выполнялись. Как написать свой скилл - в статье Скиллы Claude Code своими руками.
Не хочешь собирать набор сам - мои рабочие скиллы уже разложены в ClaudeBase, с порядком установки и проверки.
Где вы сейчас
Коротко: Сюда приходят с четырьмя разными задачами: программа ещё не стоит, хочется написать свой скилл вместо чужого, непонятно, какой выбрать, или на руках уже есть ссылка на скилл. Найди свою строку и переходи туда, где лежит ответ, а остальные разделы можно пропустить.
- Агент ещё не установлен. Сначала установи Claude Code, для Windows есть отдельная инструкция.
- Хочешь написать свой скилл. Это разобрано в статье про свои скиллы.
- Не знаешь, какой скилл взять. Смотри лучшие скиллы для Claude Code и открытый каталог.
- Есть ссылка на GitHub или папка. Читай по порядку: куда класть, как поставить, как проверить.
Куда ставить скилл: себе или в проект?
Коротко: Личные скиллы лежат в ~/.claude/skills/ и работают во всех твоих проектах на этом компьютере. Проектные лежат в .claude/skills/ внутри папки проекта, их получает каждый, кто работает с репозиторием. Каждый скилл - отдельная папка с SKILL.md внутри. Команду в меню задаёт поле name, если это имя свободно; имя папки тоже вызывает скилл.
| Куда | Путь | Где работает |
|---|---|---|
| себе | ~/.claude/skills/имя/SKILL.md |
во всех твоих проектах на этом компьютере |
| в проект | .claude/skills/имя/SKILL.md |
в сессиях этого проекта, уезжает в репозиторий |
| в плагине | плагин/skills/имя/SKILL.md |
везде, где плагин включён, вызов /плагин:имя |
| из аккаунта claude.ai | ~/.claude/skills/synced/ |
в терминале при входе этим аккаунтом, с версии 2.1.273 |
На Windows тот же путь выглядит как %USERPROFILE%\.claude\skills. Пригодится в любой папке - ставь себе. Описывает порядок работы одного проекта - клади в проект, коллеги получат его вместе с кодом.
Если одно имя есть и у личного, и у проектного скилла, срабатывает личный. Папку с именем synced не занимай: там Claude Code держит скиллы из аккаунта claude.ai, и свой скилл с таким именем он пропустит.
Как поставить скилл папкой?
Коротко: Это базовый способ, на нём держатся все остальные. Находишь папку, в которой лежит SKILL.md, и копируешь её целиком в папку скиллов. Отдельный файл или архив с обёрткой не подойдут, нужна именно папка скилла. Её имя позволяет вызвать скилл; поле name в шапке может задать команду, которую покажет меню.
- Найди папку, в которой лежит
SKILL.md. Скачал архив - сначала распакуй. - Создай папку личных скиллов и скопируй туда скилл. Пример для папки
report-helperиз «Загрузок»:
mkdir -p ~/.claude/skills
cp -R ~/Downloads/report-helper ~/.claude/skills/
- Проверь путь:
ls ~/.claude/skills/report-helper/SKILL.md
Ответ No such file or directory значит, что папка легла не туда. В проект всё так же, только в .claude/skills/ внутри проекта. На Windows проще мышкой: в %USERPROFILE%\.claude создать папку skills и перетащить в неё скилл.
Спотыкаются на двух вещах. Первая - лишний уровень после распаковки: skills/report-helper/report-helper/SKILL.md вместо схемы skills/имя/SKILL.md. Вторая - файл вместо папки: такой скилл в /skills не появится.
Если папка skills существовала при старте сессии, Claude Code замечает новые и изменённые SKILL.md без перезапуска. Если папку создали позже, выполните /reload-skills; после следующих изменений в ней повторяйте эту команду.
Как установить скилл из GitHub?
Коротко: Смотри, что лежит в репозитории. Если это коллекция, где скилл - одна папка из многих, скачай репозиторий и скопируй только нужную папку. Если в корне есть файл .claude-plugin/plugin.json, перед тобой плагин: его ставят из маркетплейса командой /plugin install или клонируют целиком, и вместе со скиллами приезжают его хуки.
Нужен Git, проверка - git --version. Если GitHub грузится через раз, сначала реши вопрос с сетью по статье Claude Code в России.
Коллекция: копируешь одну папку
Так устроен открытый набор Anthropic, репозиторий anthropics/skills: каждый скилл лежит в своей подпапке внутри skills/. Команда для Frontend Design из открытого набора Anthropic:
mkdir -p ~/.claude/skills && git clone https://github.com/anthropics/skills.git /tmp/anthropic-skills && cp -R /tmp/anthropic-skills/skills/frontend-design ~/.claude/skills/
Пример выше предназначен для macOS, Linux и WSL. Он создаёт папку скиллов, скачивает репозиторий во временную папку и копирует одну подпапку. Если /tmp/anthropic-skills уже существует, выберите другой новый путь и замените его в обеих частях команды; существующую папку не стирайте. Клон всей коллекции прямо в ~/.claude/skills/ положит скиллы глубже, чем их ищет агент. Без Git: над списком файлов на GitHub нажми Code, затем Download ZIP и перенеси папку из архива.
Плагин: из маркетплейса или клоном целиком
Так устроен Superpowers: в корне obra/superpowers лежит .claude-plugin/plugin.json. Автор в README первым предлагает официальный маркетплейс Anthropic:
/plugin install superpowers@claude-plugins-official
Способ со страницы Superpowers в каталоге, git clone в ~/.claude/skills/superpowers, тоже работает. По документации такая папка с манифестом со следующей сессии становится плагином superpowers@skills-dir. Обновлять клон придётся самому, а проверки доверия, как у плагинов в проектной папке, в личной нет.
Установка скиллов в ClaudeBase. Каталог открытых скиллов бесплатный: у каждого - что он делает, чей он и как поставить его в Claude Code и Codex. Подписчикам открыт материал «Скиллы: где брать готовые и как не поставить опасный», к нему разбор Superpowers и авторские скиллы, например хуманизация русского текста. Что ещё есть в базе.
Можно ли поставить скилл одной командой?
Коротко: Да, двумя способами. Официальный - плагин из маркетплейса: /plugin install ставит набор скиллов, а у главного каталога Anthropic обновления включены по умолчанию. Второй - сторонний установщик npx skills add от Vercel Labs, который раскладывает скиллы по папкам агентов. К Anthropic он отношения не имеет.
Через плагин из маркетплейса
Плагин - упаковка, в которой лежат скиллы, иногда с командами и хуками. Открытый набор Anthropic подключается как маркетплейс, команды из README anthropics/skills:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills
Набор example-skills включает Frontend Design, Skill Creator и другие, документы Word, Excel, PowerPoint и PDF лежат в наборе document-skills. Скилл из плагина зовётся с приставкой имени плагина через двоеточие, а короткое /frontend-design работает, пока это имя не занято другой командой. Остальное - в статье Плагины для Claude Code.
Через npx skills add - сторонний установщик
Это установщик Vercel Labs: npm-пакет skills, лицензия MIT. По README Vercel на 24 октября 2026 года нужен Node.js 22.20.0 или новее. Выполните node -v и сравните версию с этим минимумом; если она ниже, сначала обновите Node.js. Команда ниже не закрепляет версию пакета skills, поэтому историческая 1.7.0 не означает, что npx установит именно её. Так ставится Taste Skill из каталога:
npx skills add https://github.com/Leonxlnx/taste-skill --skill "design-taste-frontend"
Ключ --skill выбирает один скилл из нескольких, дальше установщик спросит агента и место. Из его README:
- с
-gскилл встаёт тебе, в~/.claude/skills/, без него - в проект, в.claude/skills/, а-a claude-codeсразу называет агента; - по умолчанию создаются символьные ссылки на общую копию,
--copyкладёт настоящие файлы; npx skills update,removeиlistобновляют, удаляют и показывают установленное;- анонимная статистика отключается переменной
DISABLE_TELEMETRY=1.
На выходе та же папка со SKILL.md, так что проверка и безопасность ниже касаются и этого способа.
Как проверить, что агент видит скилл?
Коротко: Проверьте файл на диске, список
/skillsи результат короткой задачи по отдельности. Наличие в списке подтверждает обнаружение скилла; применение проверяется на задаче из его README. Проверка формата не заменяет эти два шага.
- Убедитесь, что файл лежит прямо в
skills/имя/SKILL.md, без повторной папки с тем же именем. - В сессии выполните
/skills. Если каталогskillsпоявился после запуска Claude Code, сначала выполните/reload-skills. - Найдите скилл по имени. Если не нашли, проверьте путь и шапку файла. Для скилла из плагина проверьте, включён ли плагин.
Документация Anthropic описывает проверку каталога скиллов из терминала без запроса к модели:
claude plugin validate ~/.claude/skills --json
Для одного проекта вместо этого пути укажите .claude/skills. В JSON пофайловые замечания находятся в contents. Код 0 без замечаний по нужному файлу сам по себе не доказывает, что этот файл прочитан: чистый файл может не попасть в этот список.
В контрольном примере 24.10.2026 на macOS с Claude Code 2.1.309 валидный YAML без необязательного description дал код 0 и предупреждение об этом поле. Незакрытая кавычка в description дала код 1 и ошибку YAML. В обоих ответах указан конкретный SKILL.md, поэтому эти результаты относятся к нужным файлам. Это проверка синтаксиса; обнаружение скилла в запущенном агенте и результат его задачи здесь не проверялись.
Как позвать установленный скилл
Введите команду, которую показывает меню. У личного или проектного скилла поле name может задать имя команды, если оно не занято; имя папки тоже работает. У скилла плагина перед именем остаётся приставка плагина. Например:
/frontend-design лендинг для кофейни, тёмная тема
Возьмите короткую задачу и ожидаемый результат из README самого скилла. Вызовите его явно, затем сопоставьте ответ с этим результатом. Если скилл содержит скрипт, проверьте и его вывод: открытый SKILL.md ещё не означает успешного выполнения скрипта. Не используйте для пробы платежи, отправку сообщений или удаление файлов.
Автоматический вызов зависит от описания и настроек скилла. Пометка user-only в /skills означает, что автоматический вызов выключен. Если скилл не запускается, проверьте description и поле disable-model-invocation, а не только наличие папки.
Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF
Как обновить и удалить скилл?
Коротко: Порядок зависит от того, как ты ставил скилл. Папку обновляешь заменой файлов и удаляешь удалением папки. Плагином управляет менеджер плагинов, у официального каталога Anthropic обновления приходят сами. У стороннего установщика свои команды, а скилл из аккаунта claude.ai выключают в самом аккаунте.
| Как ставил | Обновить | Удалить |
|---|---|---|
| папкой | заменить папку новой версией | удалить папку скилла |
| клоном из GitHub | git pull внутри папки |
удалить папку, для плагина claude plugin disable имя@skills-dir |
| плагином | claude plugin update имя@каталог и перезапуск |
/plugin uninstall имя@каталог |
npx skills add |
npx skills update |
npx skills remove |
| из аккаунта claude.ai | само, проверка примерно раз в 10 минут | выключить скилл на claude.ai |
Удалённая папка пропадает из /skills в той же сессии. Скилл из аккаунта руками не удаляй: пока он включён на claude.ai, синхронизация скачает его снова.
Мешает, но удалять жалко - выдели скилл в /skills и жми пробел: состояние меняется по кругу, от видимого до выключенного, а Esc сохраняет выбор в .claude/settings.local.json. Скиллы плагинов так не выключаются, для них есть /plugin.
Что прочитать в чужом скилле до установки?
Коротко: Скилл может выполнять команды на твоей машине от твоего имени и подталкивать агента отправить данные наружу. Поэтому его читают до установки. На это уходит несколько минут: шапка файла, строки с восклицательным знаком перед командой, скрипты в папке и файл манифеста плагина, если он есть.
We recommend installing skills only from trusted sources. When installing a skill from a less-trusted source, thoroughly audit it before use.
«Мы рекомендуем ставить скиллы только из доверенных источников. Если источник не из доверенных, тщательно проверь скилл перед использованием.»
Насколько это реально, показывает аудит Snyk от 5 февраля 2026 года. Из 3 984 скиллов в каталогах ClawHub и skills.sh у 534, то есть у 13,4%, нашлась хотя бы одна критичная проблема, а 76 содержали вредоносную начинку.
Что открыть перед установкой:
- Поле
allowed-toolsв шапке. Разрешает агенту перечисленные инструменты без вопроса к тебе в ходе, где скилл вызван, и доверие к папке его не останавливает. ПравилоBash(git status *)разрешает одну команду, а голоеBashоткрывает весь терминал. - Строки
!`команда`и блоки```!. Claude Code выполняет их раньше, чем агент прочитает скилл. Строка сgit diffбезобидна. Если же скилл что-то скачивает из интернета и запускает, лучше его не ставить. - Поле
hooks. Хуки скилла включаются при вызове и работают до конца сессии. - Скрипты и файлы рядом. Справка Anthropic советует смотреть зависимости, скрипты и инструкции подключаться к незнакомым адресам.
- Файл
.claude-plugin/plugin.json. С ним папка в~/.claude/skills/становится плагином, со своими хуками и MCP-серверами.
В склонированном чужом проекте может уже лежать .claude/skills/: загляни туда до запуска агента.
Частые ошибки установки скилла
Коротко: Сообщения ниже приведены слово в слово, как их печатает Claude Code или сторонний установщик, и как поступить в каждом случае. Если после установки ломается вся сессия, запусти
claude --safe-mode: он открывает сессию без скиллов, плагинов, хуков и MCP-серверов. Проблема пропала - виновато что-то из установленного.
Unknown skill
Так Claude Code отвечает на вызов незнакомого скилла, в обращении 45525 это Unknown skill: buddy. Проверьте схему skills/имя/SKILL.md и команду из меню. Если папка skills появилась после старта сессии, выполните /reload-skills. Для плагина проверьте приставку /плагин:имя и включён ли сам плагин.
Shell command permission check failed for pattern “…”
Скилл хочет выполнить команду из строки с восклицательным знаком, а твои правила разрешений её не пропускают. Прочитай эту команду. Понятна и нужна - разреши её в настройках разрешений, непонятна - удали скилл.
Shell command failed for pattern “…”
Команда из скилла запустилась и упала, и Claude Code прервал весь вызов. Причина - в ответе самой команды после пометки [stderr].
Skill … requires bash (shell: bash in frontmatter) but Git Bash was not found
В шапке скилла указан bash, а Git Bash на компьютере с Windows нет. Документация предлагает поставить Git for Windows или использовать shell: powershell. Одна замена строки не переводит команды Bash в PowerShell: сначала убедитесь, что команды внутри скилла совместимы с выбранной оболочкой. Про Windows подробнее - в статье Claude Code на Windows.
No skills found
Ответ установщика npx skills add: в репозитории не нашлось подходящего SKILL.md. README советует проверить, что в шапке есть name и description. Какие скиллы установщик видит, покажет запуск с ключом --list.
Чек-лист
Коротко: Шесть проверок после установки любого скилла, каким бы способом он ни ставился. Если все сходятся, скилл стоит правильно и ты знаешь, что он делает на твоём компьютере. Если пункт не сходится, открой раздел про свой способ установки или список ошибок выше.
- Скилл лежит по схеме
skills/имя/SKILL.md, без лишнего уровня. - Прочитаны
allowed-tools,hooksи строки с!, если они есть. - Скрипты в папке прочитаны или источник известен.
- Скилл виден в
/skills. - Команда из меню запускает скилл, а короткая задача из README даёт ожидаемый результат.
- Ты знаешь, как обновить и удалить его при своём способе установки.
Скилл стоит - что дальше?
Коротко: Начни с одного-двух скиллов под задачу, которая у тебя повторяется каждую неделю, и поработай с ними, прежде чем брать следующие. Описание каждого скилла занимает место в контексте каждой сессии. Когда станет понятно, чего не хватает, логичный шаг - написать свой скилл или завести правила проекта.
- Выбери следующие скиллы по задачам: подборка лучших скиллов и открытый каталог.
- Нужен набор целиком, с командами и хуками, - смотри плагины для Claude Code.
- Повторяешь агенту одно и то же - заведи правила в CLAUDE.md или напиши свой скилл, а общий порядок есть в статье Claude Code: настройка с нуля.
Собирать всё по одному не обязательно: в ClaudeBase лежат мои авторские скиллы, настройки и процессы целиком, с порядком установки. Раскладывать папки вручную тоже не нужно: к базе агент ходит сам, через MCP, и достаёт оттуда то, о чём ты попросил.