Чему вы научитесь
Расчетное время: 20 минут
К концу этого урока вы сможете:
- Создавать навык с нуля с правильной структурой фронтоматтера
- Тестировать и проверять, что навык загружается корректно в Claude Code
- Объяснять, как Claude Code сопоставляет входящие запросы с доступными навыками
- Описывать иерархию приоритетов навыков (Корпоративные, Личные, Проектные, Плагины)
Создание вашего первого навыка
(4 минуты)
В этом видео показан процесс создания навыка с нуля — личного навыка для описания PR, который работает во всех ваших проектах. Вы увидите, как именно структурировать файл SKILL.md, протестируете его и поймете, как Claude Code обнаруживает и сопоставляет навыки с вашими запросами. Также в видео рассматривается иерархия приоритетов, которая определяет, какой навык будет выбран при конфликте имен.
Основные выводы
- Навык — это директория, содержащая файл SKILL.md с метаданными (название, описание) во фронтоматтере и инструкциями ниже
- Claude загружает только названия и описания навыков при запуске, затем сопоставляет входящие запросы с этими описаниями с использованием семантического поиска
- Перед загрузкой полного содержимого навыка в контекст вы получаете запрос на подтверждение
- Приоритет при конфликте имен: Корпоративные → Личные → Проектные → Плагины
- Чтобы обновить навык, отредактируйте его файл SKILL.md. Чтобы удалить — удалите директорию. Всегда перезапускайте Claude Code, чтобы изменения вступили в силу
Давайте разберем процесс создания навыка с нуля, а затем посмотрим, как Claude Code загружает и сопоставляет навыки "за кадром".
Создание навыка
Мы создадим личный навык, который научит Claude писать описания для PR в едином формате. Поскольку это личный навык, он будет находиться в вашей домашней директории и работать во всех ваших проектах.
Сначала создайте директорию для навыка внутри папки skills. Название директории должно совпадать с названием навыка:
```bash
mkdir -p ~/.claude/skills/pr-description
```
Затем создайте файл SKILL.md внутри этой директории. Файл состоит из двух частей, разделенных тире фронтоматтера:
```markdown
name: pr-description
description: Создает описания для запросов на слияние. Используется при создании PR, написании PR или когда пользователь просит резюмировать изменения для запроса на слияние.
При написании описания для PR:
- Выполните команду `git diff main...HEAD`, чтобы увидеть все изменения в этой ветке
- Напишите описание, следуя этому формату:
Что сделано
Одно предложение, объясняющее, что делает этот PR.
Зачем
Краткий контекст, почему нужны эти изменения
Изменения
- Маркированный список конкретных изменений
- Группируйте связанные изменения вместе
- Упомяните удаленные или переименованные файлы
```
Название идентифицирует ваш навык. Описание сообщает Claude, когда его использовать — это критерии сопоставления. Все, что находится после второго набора тире, — это инструкции, которым следует Claude при активации навыка.
Тестирование навыка
Claude Code загружает навыки при запуске, поэтому после создания навыка перезапустите сессию. Вы можете проверить, что навык доступен, посмотрев список доступных навыков.
Вы должны увидеть ваш навык в списке. Чтобы протестировать его, внесите изменения в ветку и скажите что-то вроде: "напиши описание для моих изменений". Claude укажет, что использует навык для описания PR, проверит ваш diff и напишет описание по вашему шаблону — в одном и том же формате каждый раз.
Как работает сопоставление навыков
При запуске Claude Code сканирует четыре местоположения для навыков, но загружает только названия и описания — не полное содержимое. Это важная деталь.
Когда вы отправляете запрос, Claude сравнивает ваше сообщение с описаниями всех доступных навыков. Например, "объясни, что делает эта функция" может сопоставиться с навыком, описанным как "объясняет код с помощью визуальных диаграмм", потому что намерения пересекаются.
После того как сопоставление найдено, Claude запрашивает подтверждение на загрузку навыка. Этот шаг подтверждения позволяет вам быть в курсе, какой контекст подгружается. После подтверждения Claude считывает полный файл SKILL.md и следует его инструкциям.
Приоритет навыков
Если вы клонируете репозиторий, в котором есть навык с таким же названием, как у вашего личного навыка, какой из них будет выбран? Существует четкий порядок приоритетов:
- Корпоративные — управляемые настройки, наивысший приоритет
- Личные — ваша домашняя директория (~/.claude/skills)
- Проектные — директория .claude/skills внутри репозитория
- Плагины — установленные плагины, наименьший приоритет
Это позволяет организациям внедрять стандарты через корпоративные навыки, сохраняя возможность индивидуальной настройки. Если в вашей компании есть корпоративный навык "review-code", а вы создадите личный навык с таким же названием, приоритет будет у корпоративной версии.
Чтобы избежать конфликтов, используйте описательные названия. Вместо просто "review" используйте что-то вроде "frontend-review" или "backend-review".
Обновление и удаление навыков
Чтобы обновить навык, отредактируйте его файл SKILL.md. Чтобы удалить — удалите директорию. После любых изменений всегда перезапускайте Claude Code, чтобы они вступили в силу.
Вопросы для размышления
- Какую задачу из вашего ежедневного рабочего процесса вы могли бы сейчас превратить в навык? Как бы выглядело его описание?
- Как иерархия приоритетов может повлиять на стратегию управления навыками в вашей команде? Вы бы больше полагались на личные или проектные навыки?
Что дальше
В следующем уроке вы узнаете о расширенных параметрах конфигурации, включая поля метаданных, ограничения инструментов с помощью allowed-tools и о том, как структурировать более крупные навыки с помощью прогрессивного раскрытия и организации в несколько файлов.
Обратная связь
По мере прохождения курса нам было бы интересно узнать, как вы используете навыки в своей работе, а также получить ваши отзывы. Поделитесь своим мнением здесь.