Три способа поставить навык: папка с SKILL.md, загрузка .zip и установка из GitHub или маркетплейса. Пошагово, со структурой SKILL.md и разбором, что делать, если скил не подхватился.
Чтобы установить skill в Claude Code, положите папку скила с файлом SKILL.md в ~/.claude/skills/ и перезапустите Claude Code, он подхватит навык автоматически. В Claude.ai зайдите в Settings → Capabilities → Skills и загрузите скилл .zip-архивом. Если скил оформлен как плагин, добавьте маркетплейс и поставьте его командой /plugin install. Все три способа разобраны ниже по шагам.
Скил (он же навык, agent skill) это папка с одним обязательным файлом SKILL.md внутри. В этом файле инструкции, которые Claude подгружает, когда они нужны под задачу. Имя папки становится командой: папка deploy даёт команду /deploy. Дальше выбирайте способ под свой случай.
Что внутри гайда
~/.claude/skills/SKILL.md и куда класть скилыСпособ 1 · Папка
Это базовый и самый частый путь. Личные скилы лежат в ~/.claude/skills/ и доступны во всех ваших проектах.
mkdir -p ~/.claude/skills/имя-скила. Имя папки это и есть будущая команда вызова.SKILL.md. Внутри папки должен лежать файл SKILL.md с инструкциями. Если вы скачали готовый навык, просто перенесите всю его папку целиком в ~/.claude/skills/.~/.claude/skills/ раньше не было вообще, нужен перезапуск, чтобы агент начал за ней следить. Если папка уже существовала, Claude подхватит новый скил прямо в текущей сессии./имя-скила.# 1. Создаём папку скила (имя = будущая команда):
mkdir -p ~/.claude/skills/имя-скила
# 2. Кладём внутрь SKILL.md (или переносим всю папку
# готового навыка целиком в ~/.claude/skills/)
# 3. Перезапускаем Claude Code, если папки skills не было
# 4. Проверяем:
# спросите «какие скилы доступны» или вызовите /имя-скилаКуда именно класть скил, зависит от того, кому он нужен:
| Где лежит | Путь | Кому доступен |
|---|---|---|
| Личный | ~/.claude/skills/<имя>/SKILL.md | Во всех ваших проектах |
| Проектный | .claude/skills/<имя>/SKILL.md | Только в этом проекте |
| Плагин | <плагин>/skills/<имя>/SKILL.md | Где включён плагин |
Проектные скилы (.claude/skills/ внутри репозитория) удобно коммитить в git, чтобы они были у всей команды.
Способ 2 · Claude.ai
Если работаете не в терминале, а в веб-версии или в десктоп-приложении Claude.ai, навык загружается архивом.
SKILL.md).Так удобно ставить готовые навыки, которые отдают одним архивом. Структура внутри та же, что и для Claude Code: папка с SKILL.md и вспомогательными файлами.
Способ 3 · GitHub
Многие навыки распространяются как плагин или как репозиторий на GitHub.
Через плагин (для скилов-плагинов и официального маркетплейса):
/plugin marketplace add владелец/репозиторий./plugin install имя-скила@маркетплейс./reload-plugins, чтобы навык стал доступен в текущей сессии.Если плагин не найден
Обновите маркетплейс командой /plugin marketplace update имя-маркетплейса и повторите установку.
Напрямую из GitHub-репозитория: склонируйте репозиторий и скопируйте папку нужного скила в ~/.claude/skills/. Например, скилы из коллекции Superpowers или официальные из anthropics/skills ставятся именно так: берёте папку навыка и кладёте к себе.
Структура
Минимальный скил это папка с одним файлом:
имя-скила/
├── SKILL.md (обязательный, главные инструкции)
├── reference.md (опционально, доп. справка)
└── scripts/ (опционально, скрипты, которые агент запускает)В самом SKILL.md сверху YAML-блок между ---, а ниже инструкции:
---
name: имя-скила
description: что делает скил и когда его применять
---
Инструкции, которым следует Claude, когда скил активен.Обязательное по сути одно поле, description: по нему агент решает, когда подтянуть навык сам. Чем точнее описание и ключевые слова в нём, тем надёжнее скил срабатывает.
Источник
Писать каждый навык руками не нужно. Готовые скилы берут из трёх мест: официальный репозиторий anthropics/skills (документы, фронтенд и другое), community-коллекции вроде Superpowers, и маркетплейс ИИ-офис, где больше тысячи навыков разложены по профессиям и категориям. На маркетплейсе удобно собрать набор под задачу: дизайн, данные, маркетинг, операции.
Коротко
SKILL.md в ~/.claude/skills/ + перезапуск./plugin install; готовые наборы — на маркетплейсе.Вопросы
Личные скилы кладут в ~/.claude/skills/<имя>/, проектные в .claude/skills/<имя>/ внутри репозитория. В каждой папке обязателен файл SKILL.md.
Если папки ~/.claude/skills/ раньше не существовало, перезапуск нужен. Если она уже была, добавленный скил подхватывается в текущей сессии без рестарта.
Проверьте, что внутри папки есть SKILL.md и что в его описании есть слова, которые вы реально говорите агенту. Спросите «какие скилы доступны», вызовите напрямую через /имя-скила. Если YAML-блок оформлен с ошибкой, запустите Claude Code с флагом --debug и посмотрите ошибку парсинга.
Папку создаёте через mkdir -p ~/.claude/skills/имя-скила, а скилы-плагины ставите через /plugin install. Отдельной команды «install skill» по умолчанию нет — скилы это файлы в папке.
Да, формат SKILL.md это открытый стандарт Agent Skills, навык переносится в Cursor, Codex и другие совместимые агенты.
Читать дальше
Прикладной материал, разборы и рабочие приёмы — то, чем пользуюсь сам, без воды. Залетай, там самое полезное.
Зайти в Telegram