Установка скилла в Claude Code

Как установить скилл в Claude Code?

Коротко: Готовый скилл - это папка с файлом SKILL.md. Её кладут в ~/.claude/skills/, чтобы скилл работал во всех проектах, или в .claude/skills/ внутри одного проекта. Из GitHub копируют нужную папку туда же, а скилл, упакованный в плагин, ставят командой /plugin install. Потом набирают /skills и ищут его в списке.

Если совсем коротко, как установить скилл в Claude Code: положить папку скилла туда, где агент их ищет. Ниже - откуда эта папка берётся и как убедиться, что агент её нашёл.

В моих рабочих проектах сейчас несколько десятков скиллов, код при этом я руками не пишу. «Клод код» и «клауд код» из поиска - это тот же агент, справка о нём есть в отдельной статье, а о самом слове «скилл» - в разборе скиллов.

Команды сверены с документацией Anthropic по состоянию на 21 сентября 2026 года и со справкой claude plugin --help (версия 2.1.278, macOS). Сам я для статьи ничего не устанавливал. Как скилл устроен и как написать свой - в статье Скиллы Claude Code своими руками, здесь только готовые.

Не хочешь собирать набор сам - мои рабочие скиллы уже разложены в ClaudeBase, с порядком установки и проверки.

Где вы сейчас

Коротко: Сюда приходят с четырьмя разными задачами: программа ещё не стоит, хочется написать свой скилл вместо чужого, непонятно, какой выбрать, или на руках уже есть ссылка на скилл. Найди свою строку и переходи туда, где лежит ответ, а остальные разделы можно пропустить.

• Агент ещё не установлен. Сначала установи Claude Code, для Windows есть отдельная инструкция.
• Хочешь написать свой скилл. Это разобрано в статье про свои скиллы.
• Не знаешь, какой скилл взять. Смотри лучшие скиллы для Claude Code и открытый каталог.
• Есть ссылка на GitHub или папка. Читай по порядку: куда класть, как поставить, как проверить.

Куда ставить скилл: себе или в проект?

Коротко: Личные скиллы лежат в ~/.claude/skills/ и работают во всех твоих проектах на этом компьютере. Проектные лежат в .claude/skills/ внутри папки проекта, их получает каждый, кто работает с репозиторием. Каждый скилл - отдельная папка с SKILL.md внутри, и имя этой папки становится командой вызова.

На Windows тот же путь выглядит как %USERPROFILE%\.claude\skills. Пригодится в любой папке - ставь себе. Описывает порядок работы одного проекта - клади в проект, коллеги получат его вместе с кодом.

Если одно имя есть и у личного, и у проектного скилла, срабатывает личный. Папку с именем synced не занимай: там Claude Code держит скиллы из аккаунта claude.ai, и свой скилл с таким именем он пропустит.

Как поставить скилл папкой?

Коротко: Это базовый способ, на нём держатся все остальные. Находишь папку, в которой лежит SKILL.md, и копируешь её целиком в папку скиллов. Отдельный файл или архив с обёрткой не подойдут, нужна именно папка скилла. Её имя станет командой, по которой ты потом будешь звать скилл.

1. Найди папку, в которой лежит SKILL.md. Скачал архив - сначала распакуй.
2. Создай папку личных скиллов и скопируй туда скилл. Пример для папки report-helper из «Загрузок»:

mkdir -p ~/.claude/skills
cp -R ~/Downloads/report-helper ~/.claude/skills/

3. Проверь путь:

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 не появится.

Перезапускать сессию не нужно, Claude Code подхватывает новые скиллы на ходу. Исключение - если папки skills не было, когда сессия запускалась: тогда перезапусти Claude Code.

Как установить скилл из GitHub?

Коротко: Смотри, что лежит в репозитории. Если это коллекция, где скилл - одна папка из многих, скачай репозиторий и скопируй только нужную папку. Если в корне есть файл .claude-plugin/plugin.json, перед тобой плагин: его ставят из маркетплейса командой /plugin install или клонируют целиком, и вместе со скиллами приезжают его хуки.

Нужен Git, проверка - git --version. Если GitHub грузится через раз, сначала реши вопрос с сетью по статье Claude Code в России.

Коллекция: копируешь одну папку

Так устроен открытый набор Anthropic, репозиторий anthropics/skills: каждый скилл лежит в своей подпапке внутри skills/. Команда для Frontend Design из нашего каталога:

git clone https://github.com/anthropics/skills.git /tmp/anthropic-skills && cp -R /tmp/anthropic-skills/skills/frontend-design ~/.claude/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, версия 1.7.0 на 21 сентября 2026 года. Нужен Node.js, проверка - node -v. Так ставится 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 в сессии: там скиллы из личной папки, проекта и плагинов. Скилла нет в списке - ищи ошибку в пути или в имени. Есть, но сам не срабатывает - смотри описание. Сломанную шапку файла ловит отдельная команда.

/skills

Список фильтруется по набранному имени, клавиша t сортирует его по числу токенов. Можно спросить и самого агента: документация Anthropic предлагает вопрос What skills are available?, можно спросить и по-русски.

Формат проверяется без сессии:

claude plugin validate ~/.claude/skills

Команда, с версии 2.1.233, сообщает о шапках SKILL.md, которые не разбираются. Для проекта путь .claude/skills, ключ --strict делает предупреждения ошибками. Сам я её для статьи не запускал: описание - по справке claude plugin validate --help, пример ответа - в разборе своих скиллов. Со сломанной шапкой скилл зовётся слешем, но сам не подключается: описание у него пустое. Причину покажет claude --debug.

Как позвать установленный скилл

Слеш и имя папки: папка frontend-design - команда /frontend-design. Поле name в шапке на команду не влияет. Скилл из аккаунта claude.ai зовётся полностью как /anthropic-skills:имя. После имени можно дописать задачу, она уйдёт в скилл аргументом:

/frontend-design лендинг для кофейни, тёмная тема

Агент подключает скилл и сам, когда задача совпадает с описанием. Пометка user-only в /skills значит, что самозапуск выключен.

Как обновить и удалить скилл?

Коротко: Порядок зависит от того, как ты ставил скилл. Папку обновляешь заменой файлов и удаляешь удалением папки. Плагином управляет менеджер плагинов, у официального каталога Anthropic обновления приходят сами. У стороннего установщика свои команды, а скилл из аккаунта 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.

«Мы рекомендуем ставить скиллы только из доверенных источников. Если источник не из доверенных, тщательно проверь скилл перед использованием.»

• Anthropic, Equipping agents for the real world with Agent Skills

Насколько это реально, показывает аудит Snyk от 5 февраля 2026 года. Из 3 984 скиллов в каталогах ClawHub и skills.sh у 534, то есть у 13,4%, нашлась хотя бы одна критичная проблема, а 76 содержали вредоносную начинку.

Что открыть перед установкой:

1. Поле allowed-tools в шапке. Разрешает агенту перечисленные инструменты без вопроса к тебе в ходе, где скилл вызван, и доверие к папке его не останавливает. Правило Bash(git status *) разрешает одну команду, а голое Bash открывает весь терминал.
2. Строки !`команда` и блоки ```!. Claude Code выполняет их раньше, чем агент прочитает скилл. Строка с git diff безобидна. Если же скилл что-то скачивает из интернета и запускает, лучше его не ставить.
3. Поле hooks. Хуки скилла включаются при вызове и работают до конца сессии.
4. Скрипты и файлы рядом. Справка Anthropic советует смотреть зависимости, скрипты и инструкции подключаться к незнакомым адресам.
5. Файл .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 при запуске сессии.

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. Про Windows подробнее - в статье Claude Code на Windows.

No skills found

Ответ установщика npx skills add: в репозитории не нашлось подходящего SKILL.md. README советует проверить, что в шапке есть name и description. Какие скиллы установщик видит, покажет запуск с ключом --list.

Чек-лист

Коротко: Шесть проверок после установки любого скилла, каким бы способом он ни ставился. Если все сходятся, скилл стоит правильно и ты знаешь, что он делает на твоём компьютере. Если пункт не сходится, открой раздел про свой способ установки или список ошибок выше.

1. Скилл лежит по схеме skills/имя/SKILL.md, без лишнего уровня.
2. Прочитаны allowed-tools, hooks и строки с !, если они есть.
3. Скрипты в папке прочитаны или источник известен.
4. Скилл виден в /skills.
5. Слеш и имя папки запускают скилл.
6. Ты знаешь, как обновить и удалить его при своём способе установки.

Скилл стоит - что дальше?

Коротко: Начни с одного-двух скиллов под задачу, которая у тебя повторяется каждую неделю, и поработай с ними, прежде чем брать следующие. Описание каждого скилла занимает место в контексте каждой сессии. Когда станет понятно, чего не хватает, логичный шаг - написать свой скилл или завести правила проекта.

1. Выбери следующие скиллы по задачам: подборка лучших скиллов и открытый каталог.
2. Нужен набор целиком, с командами и хуками, - смотри плагины для Claude Code.
3. Повторяешь агенту одно и то же - заведи правила в CLAUDE.md или напиши свой скилл, а общий порядок есть в статье Claude Code: настройка с нуля.

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