Навыки доступны пользователям планов Free, Pro, Max, Team и Enterprise. Эта функция требует включения выполнения кода. Навыки также доступны в бета-версии для пользователей Claude Code и для всех пользователей API, использующих инструмент выполнения кода.
Пользовательские навыки позволяют расширить Claude специализированными знаниями и рабочими процессами, специфичными для вашей организации или личного стиля работы. В этой статье объясняется, как создавать, структурировать и тестировать собственные навыки.
Навыки могут быть простыми — всего несколько строк инструкций — или сложными многофайловыми пакетами с исполняемым кодом. Лучшие навыки:
Решают конкретную, повторяющуюся задачу
Имеют четкие инструкции, которые Claude может выполнить
Включают примеры, когда это полезно
Определяют, когда их следует использовать
Сосредоточены на одном рабочем процессе, а не пытаются делать все
Запись навыка
Запись навыка доступна в планах Pro, Max и Team в Cowork в Claude для Mac. Она недоступна в чате, на Windows или в планах Free и Enterprise.
Вместо того чтобы писать навык вручную, вы можете записать себя, выполняющего задачу, и позволить Claude создать навык на основе наблюдений. Вы отправляете Claude видео вашего экрана, щелчков, ввода текста и голоса, а Claude предлагает навык для проверки перед сохранением.
Перед записью
Обновитесь до последней версии Claude для Mac.
Предоставьте разрешения macOS, которые Claude запрашивает при первой записи: Специальные возможности для отслеживания мыши и клавиатуры и Запись экрана для видимости экрана. macOS может попросить вас перезагрузить Claude.
Закройте все файлы, приложения или беседы, которые вы не хотите записывать.
Предупреждение: Не вводите пароли или секреты и не отображайте конфиденциальную информацию или приватные беседы во время записи. Все, что находится на вашем экране, записывается на протяжении всей сессии, а также все, что вы говорите.
Запишите свой рабочий процесс
Откройте Cowork в Claude для Mac.
Начните запись одним из двух способов:
Нажмите кнопку "+" в композере, затем выберите "Записать навык".
Перейдите в Настройка > Навыки, нажмите "Добавить", затем выберите "Записать экран".
Нажмите "Начать запись". Чтобы комментировать свои действия, оставьте микрофон включенным. Используйте элемент управления микрофоном, чтобы отключить его или выбрать другой вход.
Выполните задачу так, как вы обычно это делаете. Панель захвата показывает, что запись выполняется, и подсчитывает захваченные шаги.
Нажмите "Готово", когда закончите, или "Отменить", чтобы отбросить запись без создания чего-либо.
Запись может длиться около 10 минут. Обратный отсчет появляется на панели захвата, когда у вас остается около минуты. Когда он достигает нуля, запись останавливается и все захваченное отправляется Claude, как если бы вы нажали "Готово".
Совет: Комментируйте свои действия во время записи. Повествование дает Claude контекст, который он не может получить только с вашего экрана, например почему вы пропускаете шаг или как вы выбираете между двумя вариантами.
Что происходит после нажатия кнопки "Готово"
Claude запускает задачу Cowork и проверяет запись, затем предлагает навык. В зависимости от того, что он найдет, вы увидите одно из двух:
Новый навык, отмеченный НОВЫЙ на карточке предложения. Нажмите "Сохранить", чтобы оставить его, или "Отклонить", чтобы отбросить предложение.
Обновление существующего навыка. Если запись перекрывает навык, который у вас уже есть, Claude предлагает изменения этого навыка. На карточке показано, на каком навыке основано предложение. Нажмите "Обновить", чтобы применить изменения, или "Отклонить", чтобы отбросить их.
Разверните Содержание на карточке предложения, чтобы прочитать навык перед принятием решения.
Навыки, которые вы сохраняете из записи, появляются в Настройка > Навыки и работают как любой другой навык. Вы можете редактировать их, делиться ими и удалять их на тех же условиях.
Что сохраняется из записи
Видео и аудио из вашей записи не сохраняются. После отправки записи Claude Claude проверяет запись для создания навыка. То, что сохраняется впоследствии, — это набор снимков экрана из сессии, которые вы можете просмотреть, развернув шаг Записанная демонстрация в задаче.
Поскольку эти снимки экрана находятся в задаче Cowork, удаление задачи удаляет их. См. Начало работы с Claude Cowork, чтобы узнать, как работает удаление и сохранение задач.
Создайте файл skill.md
Каждый навык состоит из каталога, содержащего как минимум файл skill.md, который является основой навыка. Этот файл должен начинаться с YAML frontmatter для хранения обязательных полей name и description. Он также может содержать дополнительные метаданные, инструкции для Claude или справочные файлы, исполняемые скрипты или инструменты.
Обязательные поля метаданных
name: Удобное для человека имя вашего навыка (максимум 64 символа)
Пример: Рекомендации по брендингу
description: Четкое описание того, что делает навык и когда его использовать.
Это критично — Claude использует это для определения того, когда вызывать ваш навык (максимум 200 символов).
Пример: Применяйте рекомендации по брендингу Acme Corp к презентациям и документам, включая официальные цвета, шрифты и использование логотипа.
Дополнительные поля метаданных
dependencies: Пакеты программного обеспечения, требуемые вашим навыком.
Пример: python>=3.8, pandas>=1.5.0
Метаданные в файле skill.md служат первым уровнем системы прогрессивного раскрытия, предоставляя достаточно информации для Claude, чтобы знать, когда следует использовать навык, без необходимости загружать все содержимое.
Тело Markdown
Тело markdown — это второй уровень детализации после метаданных, поэтому Claude получит доступ к нему при необходимости после чтения метаданных. В зависимости от вашей задачи Claude может получить доступ к файлу skill.md и использовать навык.
Пример skill.md
Навык рекомендаций по бренду
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
Добавить ресурсы
Если у вас слишком много информации для добавления в один файл skill.md (например, разделы, применимые только к определённым сценариям), вы можете добавить больше содержимого, добавив файлы в папку навыка. Например, добавьте файл REFERENCE.md с дополнительной и справочной информацией в папку навыка. Ссылка на него в skill.md поможет Claude решить, нужно ли получить доступ к этому ресурсу при выполнении навыка.
Добавить скрипты
Для более продвинутых навыков прикрепите исполняемые файлы кода к skill.md, позволяя Claude запускать код. Например, наши навыки работы с документами используют следующие языки программирования и пакеты:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Пакеты для помощи в редактировании файлов
Инструменты визуализации
Примечание: Claude и Claude Code могут устанавливать пакеты из стандартных репозиториев (Python PyPI, JavaScript npm) при загрузке навыков. Невозможно устанавливать дополнительные пакеты во время выполнения с помощью API Skills — все зависимости должны быть предварительно установлены в контейнере.
Упаковать ваш навык
После завершения папки навыка:
Убедитесь, что имя папки совпадает с именем вашего навыка.
Создайте ZIP-файл папки.
ZIP должен содержать папку навыка в качестве корня (не подпапки).
Правильная структура:
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
Неправильная структура:
my-skill.zip
└── (файлы непосредственно в корне ZIP)
Протестируйте ваш навык
Перед загрузкой
1. Проверьте ваш skill.md на ясность.
2. Убедитесь, что описание точно отражает, когда Claude должен использовать навык.
3. Проверьте, что все упомянутые файлы существуют в правильных местах.
4. Протестируйте с примерами подсказок, чтобы убедиться, что Claude вызывает его надлежащим образом.
После загрузки в Claude
1. Включите навык в Customize > Skills.
2. Попробуйте несколько различных подсказок, которые должны его активировать.
3. Проверьте мышление Claude, чтобы подтвердить, что он загружает навык.
4. Уточните описание, если Claude не использует его при ожидаемых условиях.
Когда вы работаете над навыком с Claude в чате, вы можете редактировать файлы навыка непосредственно там, где они открываются рядом с беседой. Выделите текст, который вы хотите изменить, нажмите «Edit with Claude» и введите ваш запрос. Для навыков с несколькими файлами оставьте запросы на редактирование по файлам и отправьте их вместе, и Claude применит их за один проход. Узнайте больше об редактировании артефактов.
Примечание для планов Team и Enterprise: Чтобы сделать навык доступным для всех пользователей в вашей организации, см. Provision and manage skills for your organization.
Лучшие практики
Сосредоточьтесь на главном: Создавайте отдельные навыки для различных рабочих процессов. Несколько сосредоточенных навыков работают лучше, чем один большой навык.
Пишите ясные описания: Claude использует описания, чтобы решить, когда вызывать ваш навык. Будьте конкретны о том, когда он применяется.
Начните с простого: Начните с базовых инструкций в Markdown перед добавлением сложных скриптов. Вы всегда можете расширить навык позже.
Используйте примеры: Включите примеры входных и выходных данных в ваш файл skill.md, чтобы помочь Claude понять, как выглядит успех.
Тестируйте постепенно: Тестируйте после каждого значительного изменения, а не создавайте сложный навык сразу.
Навыки могут строиться друг на друге: Хотя навыки не могут явно ссылаться на другие навыки, Claude может использовать несколько навыков вместе автоматически. Эта композиционность — одна из самых мощных частей функции навыков.
Ознакомьтесь со спецификацией открытых Agent Skills: Следуйте рекомендациям на agentskills.io, чтобы навыки, которые вы создаёте, могли работать на платформах, которые принимают стандарт.
Для более подробного руководства по созданию навыков обратитесь к Skill authoring best practices в нашей документации Claude.
Соображения безопасности
Будьте осторожны при добавлении скриптов в ваш файл skill.md.
Не жёстко кодируйте конфиденциальную информацию (ключи API, пароли).
Проверьте все загруженные навыки перед их включением.
Используйте подходящие MCP-соединения для доступа к внешним сервисам.
Примеры навыков для справки
Посетите наш репозиторий на GitHub для примеров навыков, которые можно использовать в качестве шаблонов: https://github.com/anthropics/skills/tree/main/skills.