Навыки доступны для пользователей на бесплатных, Pro, Max, Team и Enterprise планах. Эта функция требует включения выполнения кода. Навыки также доступны в бета-версии для пользователей Claude Code и для всех пользователей API, использующих инструмент выполнения кода.
Пользовательские навыки позволяют расширить Claude специализированными знаниями и рабочими процессами, специфичными для вашей организации или личного стиля работы. В этой статье объясняется, как создавать, структурировать и тестировать собственные навыки.
Навыки могут быть простыми — всего несколько строк инструкций — или сложными многофайловыми пакетами с исполняемым кодом. Лучшие навыки:
Решают конкретную, повторяющуюся задачу
Имеют четкие инструкции, которые Claude может выполнить
Включают примеры, когда это полезно
Определяют, когда они должны использоваться
Сосредоточены на одном рабочем процессе, а не пытаются делать все
Создание файла Skill.md
Каждый навык состоит из каталога, содержащего как минимум файл Skill.md, который является основой навыка. Этот файл должен начинаться с YAML frontmatter для хранения обязательных полей name и description. Он также может содержать дополнительные метаданные, инструкции для Claude или справочные файлы, исполняемые скрипты или инструменты.
Обязательные поля метаданных
name: Удобное для человека имя вашего навыка (максимум 64 символа)
Пример: Brand Guidelines
description: Четкое описание того, что делает навык и когда его использовать.
Это критично — Claude использует это для определения того, когда вызывать ваш навык (максимум 200 символов).
Пример: Apply Acme Corp brand guidelines to presentations and documents, including official colors, fonts, and logo usage.
Дополнительные поля метаданных
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 навыков — все зависимости должны быть предварительно установлены в контейнере.
Упаковка вашего навыка
После завершения папки навыка:
Убедитесь, что имя папки совпадает с именем вашего навыка.
Создайте ZIP-файл папки.
ZIP должен содержать папку навыка в качестве корня (не подпапки).
Правильная структура:
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
Неправильная структура:
my-Skill.zip
└── (файлы непосредственно в корне ZIP)
Тестирование вашего навыка
Перед загрузкой
1. Проверьте ясность вашего Skill.md
2. Убедитесь, что описание точно отражает, когда Claude должен использовать навык
3. Проверьте, что все упомянутые файлы существуют в правильных местах
4. Протестируйте с примерами подсказок, чтобы убедиться, что Claude вызывает его надлежащим образом
После загрузки в Claude
1. Включите навык в Settings > Capabilities.
2. Попробуйте несколько различных подсказок, которые должны его вызвать
3. Проверьте мышление Claude, чтобы подтвердить, что он загружает навык
4. Повторите описание, если Claude не использует его, когда ожидается
Примечание для планов Team и Enterprise: Чтобы сделать навык доступным для всех пользователей в вашей организации, см. раздел Provisioning and managing 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.