Claude Code — инструмент в терминале, и скиллы здесь работают не так, как в приложении. Разбираем, где они лежат, чем проектные отличаются от личных и что подключают первым делом.
Короткий ответ
Скиллы в Claude Code лежат в файлах рядом с проектом или в вашей пользовательской конфигурации, а не в настройках приложения. Отсюда и главная путаница: скилл, установленный в приложении Клода, в терминале не появится, и наоборот.
Механизм тот же — папка с SKILL.md, который агент подхватывает по описанию. Разница в том, где эта папка лежит и кто её увидит.
Проектные и пользовательские — в чём разница
Пользовательские доступны вам во всех проектах. Сюда кладут то, чем пользуетесь постоянно: свой стиль кода, привычные форматы, личные шаблоны.
Проектные лежат в репозитории и приезжают ко всем, кто клонирует проект. Это способ задать команде общие правила: соглашения по коду, требования к коммитам, структура тестов.
Правило, которое избавляет от проблем: личное и с чувствительными деталями — в пользовательские, общекомандное и безопасное — в проектные. В репозиторий не должно попасть ничего, что вы не готовы показать всем, у кого есть доступ.
Та же логика, что с уровнями конфигурации MCP, и это не совпадение — механизмы соседние.
Что подключают первым
По задачам, а не по популярности:
Соглашения проекта. Самый частый и самый полезный первый скилл: как устроены модули, что где лежит, какие правила именования, чего в этом проекте не делают. Экономит объяснения при каждой задаче.
Стиль кода и ревью. Что считается приемлемым, какие паттерны запрещены, как оформлять комментарии.
Работа с фронтендом. Правила вёрстки, сетка, компоненты, конкретная библиотека анимации. Один из самых частых запросов на готовые скиллы.
Тесты. Что покрывать обязательно, как называть, где лежат фикстуры.
Документация. Формат README, changelog, комментариев к релизам.
Готовые варианты под эти задачи — в обзоре лучших скиллов, где искать — в источниках.
Скиллы и MCP: разные вещи, работают вместе
В Claude Code эти два механизма встречаются чаще всего, и путать их дорого.
MCP даёт доступ — к базе, к GitHub, к браузеру, к файлам чужого сервиса. Что агент физически может сделать. Как подключать — в разборе MCP в Claude Code.
Скилл даёт знание — как делать то, что агент и так умеет, по вашим правилам.
Пример связки: MCP подключает базу данных, скилл объясняет, как в вашем проекте принято писать миграции. Без MCP агент не увидит схему, без скилла напишет миграцию не по вашим правилам.
Проверить, что подключилось
Порядок тот же, что и в приложении, но проверять надо именно в терминале:
- Спросите, какие скиллы доступны в текущей сессии.
- Дайте задачу словами из описания скилла.
- Посмотрите, применились ли ваши правила.
Не подключился — смотрите разбор причин: чаще всего дело в размытом описании или в том, что скилл лежит не в том месте.
Про контекст
Практическая деталь, которая проявляется на больших наборах: скиллы расходуют контекст. Короткие описания агент держит постоянно, а подключённый скилл загружается целиком.
Отсюда два следствия. Держать полсотни скиллов «на всякий случай» вредно — они конкурируют за внимание и агент выбирает не тот. И длинные скиллы стоит резать на несколько узких вместо одного универсального.
Что делать, когда контекст всё-таки переполняется, — в разборе ошибки context overflow.
Чем это отличается от других инструментов
У каждого агента свой механизм для того же самого:
- Claude Code — скиллы плюс файл проекта
- Codex и OpenCode —
AGENTS.md - OpenClaw — навыки и файлы конфигурации
- Cursor — правила проекта
Идея везде одна: вынести повторяющиеся инструкции из переписки в файлы, чтобы не объяснять заново. Чем Claude Code отличается от универсального агента — в сравнении с OpenClaw.
Коротко
Скиллы в Claude Code — те же папки с SKILL.md, но живут в проекте или в вашей конфигурации, а не в настройках приложения. Начинать стоит с одного скилла про соглашения проекта: он окупается быстрее всех остальных. Что это вообще такое и чем отличается от промпта — в объяснении про скиллы.
Общие правила проекта стоит держать отдельно от скиллов — в CLAUDE.md, а если в команде разные агенты, то в AGENTS.md.