Skills доступны для пользователей на бесплатных планах, Pro, Max, Team и Enterprise. Эта функция требует включения выполнения кода. Skills также доступны в бета-версии для пользователей Claude Code и для всех пользователей API, использующих инструмент выполнения кода.
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 к презентациям и документам, включая официальные цвета, шрифты и использование логотипа.
Дополнительные поля метаданных
dependencies: Пакеты программного обеспечения, требуемые вашим Skill.
Пример: python>=3.8, pandas>=1.5.0
Метаданные в файле Skill.md служат первым уровнем системы прогрессивного раскрытия информации, предоставляя достаточно информации для Claude, чтобы знать, когда Skill должен использоваться, без необходимости загружать все содержимое.
Тело Markdown
Тело Markdown — это второй уровень детализации после метаданных, поэтому Claude получит доступ к нему, если потребуется, после прочтения метаданных. В зависимости от вашей задачи Claude может получить доступ к файлу Skill.md и использовать Skill.
Пример Skill.md
Skill рекомендаций по брендингу
## 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 (например, разделы, которые применяются только к определенным сценариям), вы можете добавить больше содержимого, добавив файлы в директорию Skill. Например, добавьте файл REFERENCE.md, содержащий дополнительную и справочную информацию в директорию Skill. Ссылка на него в Skill.md поможет Claude решить, нужно ли ему получить доступ к этому ресурсу при выполнении Skill.
Добавьте скрипты
Для более продвинутых Skills прикрепите исполняемые файлы кода к Skill.md, позволяя Claude запускать код. Например, наши document skills используют следующие языки программирования и пакеты:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Пакеты для помощи с редактированием файлов
инструменты визуализации
Примечание: Claude и Claude Code могут устанавливать пакеты из стандартных репозиториев (Python PyPI, JavaScript npm) при загрузке Skills. Невозможно устанавливать дополнительные пакеты во время выполнения с API Skills — все зависимости должны быть предварительно установлены в контейнере.
Упакуйте ваш Skill
После завершения папки Skill:
Убедитесь, что имя папки совпадает с именем вашего Skill.
Создайте ZIP-файл папки.
ZIP должен содержать папку Skill в качестве корня (не подпапки).
Правильная структура:
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
Неправильная структура:
my-Skill.zip
└── (файлы непосредственно в корне ZIP)
Протестируйте ваш Skill
Перед загрузкой
1. Проверьте ваш Skill.md на ясность
2. Убедитесь, что описание точно отражает, когда Claude должен использовать Skill
3. Проверьте, что все упомянутые файлы существуют в правильных местах
4. Протестируйте с примерами подсказок, чтобы убедиться, что Claude вызывает его надлежащим образом
После загрузки в Claude
1. Включите Skill в Customize > Skills.
2. Попробуйте несколько различных подсказок, которые должны его вызвать
3. Проверьте мышление Claude, чтобы подтвердить, что он загружает Skill
4. Повторите описание, если Claude не использует его, когда ожидается
Примечание для планов Team и Enterprise: Чтобы сделать Skill доступным для всех пользователей в вашей организации, см. Provision and manage Skills for your organization.
Лучшие практики
Держите это сосредоточенным: Создавайте отдельные Skills для различных рабочих процессов. Несколько сосредоточенных Skills работают лучше, чем один большой Skill.
Пишите четкие описания: Claude использует описания для решения о вызове вашего Skill. Будьте конкретны о том, когда он применяется.
Начните с простого: Начните с базовых инструкций в Markdown перед добавлением сложных скриптов. Вы всегда можете расширить Skill позже.
Используйте примеры: Включите примеры входных и выходных данных в ваш файл Skill.md, чтобы помочь Claude понять, как выглядит успех.
Тестируйте постепенно: Тестируйте после каждого значительного изменения, а не создавайте сложный Skill сразу.
Skills могут строиться друг на друге: Хотя Skills не могут явно ссылаться на другие Skills, Claude может автоматически использовать несколько Skills вместе. Эта композиция — одна из самых мощных частей функции Skills.
Ознакомьтесь со спецификацией открытого Agent Skills: Следуйте рекомендациям на agentskills.io, чтобы Skills, которые вы создаете, могли работать на платформах, которые принимают стандарт.
Для более подробного руководства по созданию Skills обратитесь к Skill authoring best practices в нашей Claude Docs.
Соображения безопасности
Будьте осторожны при добавлении скриптов в ваш файл Skill.md.
Не кодируйте чувствительную информацию (ключи API, пароли).
Проверьте любые Skills, которые вы загружаете, перед их включением.
Используйте соответствующие MCP соединения для доступа к внешним сервисам.
Примеры Skills для справки
Посетите наш репозиторий на GitHub для примеров Skills, которые вы можете использовать как шаблоны: https://github.com/anthropics/skills/tree/main/skills.