Навыки агентов

Примерное время: 20 минут

К концу этого урока вы сможете:

• Создавать навыки с нуля с правильной структурой frontmatter
• Тестировать и проверять корректность загрузки навыка в Claude Code
• Объяснять, как Claude Code сопоставляет входящие запросы с доступными навыками
• Описывать иерархию приоритетов навыков (Enterprise, Personal, Project, Plugins)

Создание вашего первого навыка

(4 минуты)

В этом видео подробно рассматривается создание навыка с нуля — персонального навыка для описания PR, который работает во всех ваших проектах. Вы увидите, как правильно структурировать файл SKILL.md, тестировать его и понимать, как Claude Code обнаруживает и сопоставляет навыки с вашими запросами. Видео также охватывает иерархию приоритетов, которая определяет, какой навык будет выбран при конфликте имен.

Основные выводы

• Навык — это директория, содержащая файл SKILL.md с метаданными (name, description) в frontmatter и инструкциями ниже
• Claude загружает только имена и описания навыков при запуске, затем сопоставляет входящие запросы с этими описаниями, используя semantic matching
• Вы получаете запрос на подтверждение, прежде чем Claude загрузит полное содержимое навыка в контекст
• Приоритет при конфликтах имен: Enterprise → Personal → Project → Plugins
• Чтобы обновить навык, отредактируйте его SKILL.md. Чтобы удалить, удалите его директорию. Всегда перезапускайте Claude Code, чтобы изменения вступили в силу

Давайте рассмотрим создание навыка с нуля, а затем посмотрим, как Claude Code фактически загружает и сопоставляет навыки за кулисами.

Создание навыка

Мы создадим персональный навык, который научит Claude писать описания PR в согласованном формате. Поскольку это персональный навык, он будет находиться в вашей домашней директории и работать во всех ваших проектах.

Сначала создайте директорию для вашего навыка внутри папки skills. Имя директории должно соответствовать имени вашего навыка:

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

Затем создайте файл SKILL.md внутри этой директории. Файл состоит из двух частей, разделенных тире frontmatter:

---
name: pr-description
description: Writes pull request descriptions. Use when creating a PR, writing a PR, or when the user asks to summarize changes for a pull request.
---

When writing a PR description:

1. Run `git diff main...HEAD` to see all changes on this branch
2. Write a description following this format:

## What
One sentence explaining what this PR does.

## Why
Brief context on why this change is needed

## Changes
- Bullet points of specific changes made
- Group related changes together
- Mention any files deleted or renamed

Name идентифицирует ваш навык. Description сообщает Claude, когда его использовать — это критерий сопоставления. Все, что находится после второго набора тире, — это инструкции, которым Claude следует при активации навыка.

Тестирование вашего навыка

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

Вы должны увидеть свой навык в списке. Чтобы протестировать его, внесите некоторые изменения в branch и скажите что-то вроде "write a PR description for my changes." Claude укажет, что использует навык описания PR, проверит ваш diff, и напишет описание, следуя вашему template — каждый раз в одном и том же формате.

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

При запуске Claude Code сканирует четыре местоположения на наличие навыков, но загружает только name и description — не полное содержимое. Это важная деталь.

Когда вы отправляете запрос, Claude сравнивает ваше сообщение с описаниями всех доступных навыков. Например, фраза "explain what this function does" будет соответствовать навыку, описанному как "explain code with visual diagrams", потому что их намерения совпадают.

Как только совпадение найдено, Claude просит вас подтвердить загрузку навыка. Этот шаг подтверждения позволяет вам быть в курсе того, какой контекст Claude использует. После вашего подтверждения Claude считывает полный файл SKILL.md и следует его инструкциям.

Приоритет навыков

Если вы клонируете repository, в котором есть навык с тем же именем, что и один из ваших персональных навыков, какой из них будет иметь приоритет? Существует четкий порядок приоритетов:

1. Enterprise — управляемые настройки, наивысший приоритет
2. Personal — ваша домашняя директория (~/.claude/skills)
3. Project — директория .claude/skills внутри repository
4. Plugins — установленные plugins, наименьший приоритет

Это позволяет организациям устанавливать стандарты с помощью enterprise skills, при этом допуская индивидуальную настройку. Если у вашей компании есть enterprise "code-review" skill и вы создаете personal "code-review" skill с тем же именем, enterprise версия будет иметь приоритет.

Чтобы избежать конфликтов, используйте описательные имена. Вместо просто "review" используйте что-то вроде "frontend-review" или "backend-review."

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

Чтобы обновить навык, отредактируйте его файл SKILL.md. Чтобы удалить навык, удалите его директорию. Перезапустите Claude Code после любых изменений, чтобы они вступили в силу.

Размышления по уроку

• Какую одну задачу из вашего ежедневного рабочего процесса вы могли бы прямо сейчас превратить в навык? Как бы выглядело его описание?
• Как иерархия приоритетов может повлиять на стратегию управления навыками вашей команды? Будете ли вы больше полагаться на персональные навыки или навыки уровня проекта?

Что дальше

В следующем уроке вы узнаете о расширенных параметрах конфигурации, включая поля metadata, ограничения инструментов с помощью allowed-tools, а также о том, как структурировать более крупные навыки, используя progressive disclosure и multi-file organization.

Обратная связь

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