Навыки доступны пользователям на тарифах Free, Pro, Max, Team и Enterprise. Эта функция требует включения выполнения кода. Навыки также доступны в бета-версии для пользователей Claude Code и для всех пользователей API, использующих инструмент выполнения кода.
Пользовательские навыки позволяют расширить Claude специализированными знаниями и рабочими процессами, специфичными для вашей организации или личного стиля работы. В этой статье объясняется, как создавать, структурировать и тестировать собственные навыки.
Навыки могут быть простыми — всего несколько строк инструкций — или сложными, представляя собой многофайловые пакеты с исполняемым кодом. Лучшие навыки:
Решают конкретную, повторяющуюся задачу
Имеют четкие инструкции, которые Claude может выполнить
Включают примеры, когда это полезно
Определяют, когда они должны использоваться
Сосредоточены на одном рабочем процессе, а не пытаются делать все
Создайте файл skill.md
Каждый навык состоит из каталога, содержащего как минимум файл skill.md, который является ядром навыка. Этот файл должен начинаться с YAML-преамбулы для хранения обязательных полей name и description. Он также может содержать дополнительные метаданные, инструкции для Claude или справочные файлы, исполняемые скрипты или инструменты.
Обязательные поля метаданных
name: Удобное для человека имя вашего навыка (максимум 64 символа)
Пример: Brand Guidelines
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: Чтобы сделать навык доступным для всех пользователей в вашей организации, см. Подготовка и управление навыками для вашей организации.
Лучшие практики
Сохраняйте фокус: Создавайте отдельные навыки для различных рабочих процессов. Несколько сосредоточенных навыков работают лучше, чем один большой навык.
Пишите четкие описания: Claude использует описания для решения о вызове вашего навыка. Будьте конкретны о том, когда он применяется.
Начните с простого: Начните с базовых инструкций в Markdown перед добавлением сложных скриптов. Вы всегда можете расширить навык позже.
Используйте примеры: Включите примеры входных и выходных данных в ваш файл skill.md, чтобы помочь Claude понять, как выглядит успех.
Тестируйте постепенно: Тестируйте после каждого значительного изменения, а не создавайте сложный навык сразу.
Навыки могут строиться друг на друге: Хотя навыки не могут явно ссылаться на другие навыки, Claude может автоматически использовать несколько навыков вместе. Эта композиция — одна из самых мощных частей функции навыков.
Ознакомьтесь со спецификацией открытых Agent Skills: Следуйте рекомендациям на agentskills.io, чтобы навыки, которые вы создаете, могли работать на платформах, которые принимают стандарт.
Для более подробного руководства по созданию навыков обратитесь к Лучшим практикам разработки навыков в нашей документации Claude.
Соображения безопасности
Будьте осторожны при добавлении скриптов в ваш файл skill.md.
Не жестко кодируйте конфиденциальную информацию (ключи API, пароли).
Проверьте любые навыки, которые вы загружаете, перед их включением.
Используйте соответствующие подключения MCP для доступа к внешним сервисам.
Примеры навыков для справки
Посетите наш репозиторий на GitHub для примеров навыков, которые вы можете использовать в качестве шаблонов: https://github.com/anthropics/skills/tree/main/skills.