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

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

Skill, или навык, — папка с инструкциями в файле SKILL.md и, при необходимости, дополнительными материалами. Такой формат позволяет передавать агенту повторяемую процедуру вместе с примерами и вспомогательными файлами. Устройство формата описано в спецификации Agent Skills.

• спецификации Agent Skills

Здесь разберём установку в локальный Claude Code и создадим учебный навык для проверки формы заявки. Команды сверены с документацией; сам пример не является отчётом о тестировании на реальном сайте.

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

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

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

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

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

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

• Расположение 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

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

После установки посмотрите сообщение Claude Code. Если требуется активация, выполните `/reload-plugins`; ошибки доступны в меню `/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`; имя соответствует имени папки. В примере используются строчные латинские буквы и дефис. Формат SKILL.md.

• Формат SKILL.md

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

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

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

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

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

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

• Вызов Skills

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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