Skills в Claude Code: как установить готовый навык и создать свой

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

Skill, или навык, — это папка с инструкциями в файле SKILL.md и, если нужно, дополнительными материалами. В ней агент получает повторяемую процедуру вместе с примерами и вспомогательными файлами. Формат описан в спецификации Agent Skills.

• Agent Skills: спецификация формата

Ниже — установка в локальный Claude Code и учебный навык для проверки формы заявки. Команды сверены с документацией 3 октября 2026 года. Сам пример учебный, это не отчёт о тестировании на реальном сайте.

Для какой задачи стоит создавать Skill

Выбирайте процедуру, которую уже можете объяснить словами. Например: «Перед сдачей формы проверить обязательные поля, сообщения об ошибках и поведение после отправки, а затем перечислить найденные проблемы».

Для первого навыка это удобнее, чем расплывчатое «делай качественные сайты». У проверки формы есть входные данные, последовательность действий и результат, который можно оценить.

Начните с одной строки этой таблицы. Навык, который сразу и разрабатывает сайт, и пишет рекламу, и настраивает сервер, и публикует результат, трудно чинить: непонятно, какой этап дал сбой.

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

В локальном Claude Code личные навыки лежат в `~/.claude/skills/`, проектные — в `.claude/skills/` внутри репозитория. У каждого навыка своя папка с SKILL.md. Личный доступен во всех проектах на этой машине, проектный удобно хранить вместе с кодом.

• Расположение Skills

Для навыка `form-review` структура проекта будет такой:

project/
└── .claude/
    └── skills/
        └── form-review/
            ├── SKILL.md
            └── references/
                └── checklist.md

Если скачали архив с набором навыков, откройте его и найдите папку нужного навыка. Перенесите её целиком: копирование одного SKILL.md может оборвать ссылки на приложенные материалы.

Проверьте итоговое дерево каталогов. Частая ошибка при распаковке — лишний уровень вложенности:

.claude/skills/form-review/form-review/SKILL.md

В нашем примере файл должен находиться на один уровень выше:

.claude/skills/form-review/SKILL.md

Перед копированием посмотрите, нет ли уже папки с таким именем. Если есть, сначала сравните версии, иначе можно затереть собственные правки.

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

Если автор распространяет навыки как плагин, ставьте их по его инструкции. Для официального репозитория Anthropic команды такие, вводят их внутри Claude Code:

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

Первая команда добавляет маркетплейс, вторая устанавливает набор примеров. Для набора работы с документами в том же репозитории указан `document-skills@anthropic-agent-skills`. Названия и команды приведены в README anthropics/skills.

• README anthropics/skills

Папка с навыком и плагин — разные способы распространения. Одиночный SKILL.md, найденный на GitHub, командой `/plugin install` не поставить: сначала выясните, есть ли у автора пакет для установки через маркетплейс.

Команда `/plugin install` открывает карточку плагина, где выбирают область установки: лично для вас, для всех участников проекта или только для вас в этом проекте. После установки прочитайте итоговое сообщение. Если плагину нужна перезагрузка, Claude Code обычно сам выполняет `/reload-plugins`. Если плагин не загрузился, причина указана на вкладке Errors в меню `/plugin`.

• Установка плагинов

Что проверить в чужом навыке

До первого запуска прочитайте SKILL.md и приложенные скрипты и сопоставьте их с задачей. Если навык нужен для обзора формы, а он отправляет содержимое репозитория на внешний сервер, это требует отдельного объяснения.

Полезно записать три вещи: откуда взят навык, какая версия используется и что вы в нём изменили. Если после обновления поменяется результат, будет с чем сравнить инструкции.

Посмотрите и на исходные предположения. Автор мог писать навык под конкретный фреймворк, набор команд или браузерный инструмент, которых в вашем проекте нет. Такие места придётся заменить своими: обещание «работает везде» ничего не гарантирует.

Создаём свой Skill: проверка формы заявки

Наш навык читает реализацию формы и составляет отчёт. Код он не исправляет и заявки не отправляет: так проще отделить поиск проблемы от её устранения.

Создайте каталог `.claude/skills/form-review/` в редакторе. В macOS, Linux или WSL можно использовать терминал:

mkdir -p .claude/skills/form-review

Затем создайте в нём SKILL.md с таким содержимым. Пример учебный, его нужно адаптировать к своему проекту.

---
name: form-review
description: Проверяет реализацию формы заявки и составляет отчёт о валидации, сообщениях и отправке. Используй для ревью формы перед выпуском.
disable-model-invocation: true
---

# Проверка формы заявки

## Цель

Найти ошибки в реализации формы и указать, что ещё нужно проверить.
Работай только с чтением файлов. Не меняй код, не отправляй форму
и не обращайся к внешним сервисам.

## Входные данные

Нужен путь к форме или название пользовательского сценария.
Если подходят несколько форм, уточни, какую проверить.

## Порядок

1. Прочитай компонент формы, её обработчик и связанные тесты.
2. Найди обязательные поля и правила их проверки.
3. Проверь по коду обработку пустого значения и неверного email.
4. Проследи состояния отправки, успеха и ошибки.
5. Проверь, что повторное нажатие кнопки во время отправки
   обработано явно; если это неясно, опиши неопределённость.
6. Сопоставь выводы с тестами. Наличие теста не означает,
   что он был выполнен и прошёл.

## Отчёт

Для каждой проблемы укажи:
- файл и место в коде;
- условие, при котором возникает проблема;
- возможное последствие для пользователя;
- предложенную проверку или исправление.

Отдельно перечисли поведение, которое можно подтвердить только
запуском приложения. Если явных проблем не нашёл, сообщи об этом
без утверждения, что форма полностью проверена.

В начале файла, между строками `---`, идут метаданные, ниже — сама процедура. Открытая спецификация Agent Skills требует поля `name` и `description`, причём имя должно совпадать с именем папки. Сам Claude Code мягче: в нём все поля необязательны, рекомендуется только `description`. В имени допустимы строчные латинские буквы, цифры и дефис.

• Формат SKILL.md

Поле `disable-model-invocation: true` — настройка Claude Code: с ней навык запускается только вручную, сам Claude его не подгружает. Здесь она нужна, чтобы проверка начиналась по явной команде. Слова «только чтение» в инструкции описывают поведение, а технические права доступа настраиваются отдельно.

• Управление вызовом
• Claude Code: разрешения инструментов

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

Откройте проект в Claude Code и введите:

/form-review Проверь форму заявки в src/components/LeadForm.tsx

Путь здесь условный — укажите существующий файл своего проекта. Прямой вызов навыка имеет вид `/имя-навыка`.

• Вызов Skills

Для проверки возьмите форму с уже известной особенностью. Например, сообщение об ошибке отправки исчезает сразу после повторного нажатия. Посмотрите, заметит ли агент именно это и сможет ли показать причину в коде.

Оцените отчёт по четырём признакам:

1. Указаны существующие файлы и конкретные участки реализации.
2. Каждое замечание описывает условие возникновения проблемы.
3. Предположения отделены от выводов, подтверждённых кодом.
4. Чтение тестов не выдано за их успешный запуск.

Если вместо этого пришёл длинный список общих советов, ужесточите требование к доказательствам. Например, добавьте: «Не включай рекомендацию, пока не показал связанный с ней участок реализации». И повторите проверку на той же форме.

Меняйте одну существенную часть инструкции за раз, иначе не поймёте, какая правка сделала ответ полезнее. Это описание редакционной методики проверки; результатов тестирования навыка здесь нет.

Как написать описание для автоматического выбора

Если навык должен выбираться автоматически, опишите и действие, и повод его применить. Сравните:

Помогает разрабатывать приложения.

И более точный вариант:

Проверяет формы заявки перед выпуском: валидацию полей, сообщения об ошибках и состояния отправки. Используй при запросе на ревью формы; не используй для общего обзора архитектуры.

Во втором варианте видны границы, и у агента меньше поводов выбрать навык для посторонней задачи. Спецификация тоже рекомендует писать в `description`, что делает навык и когда он нужен.

• Требования к описанию

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

Почему Skill не появляется или не срабатывает

Сначала проверьте путь, имя файла SKILL.md и начало YAML-блока: открывающая строка `---` должна быть первой. Правки в уже существующих папках навыков Claude Code подхватывает прямо в сессии. Если же каталог верхнего уровня `.claude/skills/` создан после запуска сессии, выполните `/reload-skills`.

• Редактирование и загрузка навыков

Затем разделите две ситуации. Навык не найден при прямом вызове — проверяйте установку. Навык вызывается вручную, но агент не выбирает его сам — проверяйте режим вызова и описание.

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

• Совпадение имён