Custom Skills позволяют расширить Claude специализированными знаниями и рабочими процессами, специфичными для вашей организации или личного стиля работы. В этой статье объясняется, как создавать, структурировать и тестировать собственные Skills.
Skills могут быть простыми — всего несколько строк инструкций — или сложными многофайловыми пакетами с исполняемым кодом. Лучшие Skills:
Решают конкретную, повторяющуюся задачу
Содержат четкие инструкции, которые Claude может выполнить
Включают примеры, когда это полезно
Определяют, когда их следует использовать
Сосредоточены на одном рабочем процессе, а не пытаются делать все
Создание файла Skill.md
Каждый Skill состоит из директории, содержащей как минимум файл Skill.md, который является ядром Skill. Этот файл должен начинаться с YAML frontmatter для хранения обязательных полей name и description. Он также может содержать дополнительные метаданные, инструкции для Claude, справочные файлы, исполняемые скрипты или инструменты.
Обязательные поля метаданных
name: Удобное для человека имя вашего Skill (максимум 64 символа)
Пример: Brand Guidelines
description: Четкое описание того, что делает Skill и когда его использовать.
Это критически важно — Claude использует это для определения того, когда вызывать ваш Skill (максимум 200 символов).
Пример: Применяйте рекомендации по брендингу Acme Corp к презентациям и документам, включая официальные цвета, шрифты и использование логотипа.
Дополнительные поля метаданных
version: Отслеживайте версии вашего Skill по мере его развития.
Пример: 1.0.0
dependencies: Пакеты программного обеспечения, необходимые для вашего Skill.
Пример: python>=3.8, pandas>=1.5.0
Метаданные в файле Skill.md служат первым уровнем системы постепенного раскрытия информации, предоставляя достаточно информации для Claude, чтобы знать, когда следует использовать Skill, без необходимости загружать все содержимое.
Основной текст Markdown
Основной текст Markdown — это второй уровень детализации после метаданных, поэтому Claude получит доступ к нему при необходимости после прочтения метаданных. В зависимости от вашей задачи Claude может получить доступ к файлу Skill.md и использовать Skill.
Пример Skill.md
Skill Brand Guidelines
## Метаданные
name: Brand Guidelines
description: Применяйте рекомендации по брендингу Acme Corp ко всем презентациям и документам
version: 1.0.0
## Обзор
Этот Skill предоставляет официальные рекомендации по брендингу Acme Corp для создания согласованных профессиональных материалов. При создании презентаций, документов или маркетинговых материалов применяйте эти стандарты, чтобы все выходные данные соответствовали визуальной идентичности Acme. Claude должен ссылаться на эти рекомендации при создании внешних материалов или документов, представляющих Acme Corp.
## Цвета бренда
Наши официальные цвета бренда:
- Основной: #FF6B35 (Коралл)
- Вторичный: #004E89 (Темно-синий)
- Акцент: #F7B801 (Золото)
- Нейтральный: #2E2E2E (Уголь)
## Типография
Заголовки: Montserrat Bold
Основной текст: Open Sans Regular
Рекомендации по размеру:
- H1: 32pt
- H2: 24pt
- Основной текст: 11pt
## Использование логотипа
Всегда используйте полноцветный логотип на светлом фоне. Используйте белый логотип на темном фоне. Сохраняйте минимальный отступ 0,5 дюйма вокруг логотипа.
## Когда применять
Применяйте эти рекомендации при создании:
- Презентаций PowerPoint
- Документов Word для внешнего обмена
- Маркетинговых материалов
- Отчетов для клиентов
## Ресурсы
См. папку ресурсов для файлов логотипов и загрузок шрифтов.
Добавление ресурсов
Если у вас слишком много информации для добавления в один файл Skill.md (например, разделы, которые применяются только к конкретным сценариям), вы можете добавить больше содержимого, добавив файлы в директорию вашего Skill. Например, добавьте файл REFERENCE.md, содержащий дополнительную и справочную информацию, в директорию вашего Skill. Ссылка на него в Skill.md поможет Claude решить, нужно ли ему получить доступ к этому ресурсу при выполнении Skill.
Добавление скриптов
Для более продвинутых Skills прикрепите исполняемые файлы кода к Skill.md, позволяя Claude запускать код. Например, наши Skills для работы с документами используют следующие языки программирования и пакеты:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Пакеты для помощи в редактировании файлов
Инструменты визуализации
Примечание: Claude и Claude Code могут устанавливать пакеты из стандартных репозиториев (Python PyPI, JavaScript npm) при загрузке Skills. Невозможно устанавливать дополнительные пакеты во время выполнения с API Skills — все зависимости должны быть предварительно установлены в контейнере.