Создаём первый навык с нуля

⏱️ Примерное время: ~12 минут · 🎯 Урок 2 курса «Введение в Agent Skills» · 🎬 видео

В этом уроке мы с нуля создадим ваш первый навык — персональный навык для написания описаний пулл-реквестов (PR-description), который будет работать сразу во всех ваших проектах.

Создаём структуру навыка

Начните с создания директории для навыка:

mkdir -p ~/.claude/skills/pr-description

Затем создайте внутри файл SKILL.md. У него есть две части:

Фронтматтер (frontmatter) — блок метаданных в начале файла с полями name (имя) и description (описание).
Инструкции — основной текст навыка, который располагается ниже разделителя из дефисов.

Поле description — это и есть критерий сопоставления. Именно по нему Claude понимает, когда ваш навык нужно применить.

Как Claude загружает навыки

Claude Code загружает навыки при запуске, но считывает при этом только имя и описание (name + description), а не всё содержимое файла. Поэтому после создания нового навыка перезапустите сессию, чтобы Claude его обнаружил.

Практика: проверьте навык в деле

Попробуйте сами: скажите Claude что-нибудь вроде «напиши описание пулл-реквеста для моих изменений» (*write a PR description for my changes*). В ответ Claude:

сообщит, что использует ваш навык;
проверит ваш diff (различия в коде);
напишет описание, следуя заданному вами шаблону.

Как работает сопоставление

Механизм сопоставления (matching) устроен так:

Claude сканирует четыре расположения, где могут лежать навыки.
Загружает только имя и описание каждого навыка (name + description).
Сравнивает ваш запрос с этими описаниями по смыслу (семантически).
Просит вас подтвердить загрузку подходящего навыка.
После подтверждения считывает весь файл SKILL.md целиком.

Приоритет при конфликте имён

Если у нескольких навыков совпадают имена, Claude разрешает конфликт по следующему приоритету:

Приоритет	Источник навыка
1 (высший)	Корпоративный (Enterprise)
2	Персональный (Personal)
3	Проектный (Project)
4 (низший)	Плагины (Plugins)

Чтобы избежать таких конфликтов, давайте навыкам понятные, описательные имена.

Обновление и удаление навыков

Чтобы обновить навык: отредактируйте его файл SKILL.md.
Чтобы удалить навык: удалите его директорию.

Всегда перезапускайте Claude Code после внесения изменений — только так Claude подхватит обновлённый или удалённый навык.