Agent Skills

Зачем использовать Skills

Skills — это переиспользуемые ресурсы на основе файловой системы, которые предоставляют Claude специализированные знания в конкретной области: рабочие процессы, контекст и лучшие практики, которые превращают универсальные агенты в специалистов. В отличие от подсказок (инструкции на уровне беседы для разовых задач), Skills загружаются по требованию и устраняют необходимость повторно предоставлять одно и то же руководство в нескольких беседах.

Ключевые преимущества:

• Специализируйте Claude: адаптируйте возможности для задач, специфичных для конкретной области
• Снизьте повторение: создайте один раз, используйте автоматически
• Комбинируйте возможности: объедините Skills для создания сложных рабочих процессов

Использование Skills

Anthropic предоставляет предварительно созданные Agent Skills для распространённых задач с документами (PowerPoint, Excel, Word, PDF), и вы можете создавать свои собственные пользовательские Skills. Оба работают одинаково. Claude автоматически использует их, когда это уместно для вашего запроса.

Предварительно созданные Agent Skills доступны всем пользователям на claude.ai и через Claude API. Полный список см. в разделе Доступные Skills ниже.

Пользовательские Skills позволяют упаковать специализированные знания и организационные знания. Они доступны во всех продуктах Claude: создавайте их в Claude Code, загружайте через API или добавляйте в параметры claude.ai.

Как работают Skills

Skills используют окружение VM Claude для предоставления возможностей, которые невозможны только с подсказками. Claude работает на виртуальной машине с доступом к файловой системе, позволяя Skills существовать как каталогам, содержащим инструкции, исполняемый код и справочные материалы, организованные как руководство по адаптации, которое вы создали бы для нового члена команды.

Эта архитектура на основе файловой системы обеспечивает постепенное раскрытие: Claude загружает информацию поэтапно по мере необходимости, а не потребляя контекст заранее.

Три типа содержимого Skill, три уровня загрузки

Skills могут содержать три типа содержимого, каждый загружается в разное время:

Уровень 1: Метаданные (всегда загружаются)

Тип содержимого: Инструкции. Frontmatter YAML Skill предоставляет информацию об обнаружении:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claude загружает эти метаданные при запуске и включает их в системную подсказку. Этот лёгкий подход означает, что вы можете установить много Skills без штрафа за контекст; Claude только знает, что каждый Skill существует и когда его использовать.

Уровень 2: Инструкции (загружаются при срабатывании)

Тип содержимого: Инструкции. Основной текст SKILL.md содержит процедурные знания: рабочие процессы, лучшие практики и руководство:

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Когда вы запрашиваете что-то, что соответствует описанию Skill, Claude читает SKILL.md из файловой системы через bash. Только тогда это содержимое попадает в окно контекста.

Уровень 3: Ресурсы и код (загружаются по мере необходимости)

Типы содержимого: Инструкции, код и ресурсы. Skills могут включать дополнительные материалы:

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

Инструкции: дополнительные файлы markdown (FORMS.md, REFERENCE.md), содержащие специализированное руководство и рабочие процессы

Код: исполняемые скрипты (fill_form.py, validate.py), которые Claude запускает через bash; скрипты обеспечивают детерминированные операции без потребления контекста

Ресурсы: справочные материалы, такие как схемы баз данных, документация API, шаблоны или примеры

Claude получает доступ к этим файлам только при ссылке на них. Модель файловой системы означает, что каждый тип содержимого имеет разные сильные стороны: инструкции для гибкого руководства, код для надёжности, ресурсы для фактического поиска.

Постепенное раскрытие гарантирует, что только релевантное содержимое занимает окно контекста в любой момент времени.

Архитектура Skills

Skills работают в окружении выполнения кода, где Claude имеет доступ к файловой системе, командам bash и возможностям выполнения кода. Думайте об этом так: Skills существуют как каталоги на виртуальной машине, и Claude взаимодействует с ними, используя те же команды bash, которые вы использовали бы для навигации по файлам на вашем компьютере.

Как Claude получает доступ к содержимому Skill:

Когда Skill срабатывает, Claude использует bash для чтения SKILL.md из файловой системы, внося его инструкции в окно контекста. Если эти инструкции ссылаются на другие файлы (такие как FORMS.md или схема базы данных), Claude также читает эти файлы, используя дополнительные команды bash. Когда инструкции упоминают исполняемые скрипты, Claude запускает их через bash и получает только вывод (код скрипта никогда не попадает в контекст).

Что эта архитектура обеспечивает:

Доступ к файлам по требованию: Claude читает только файлы, необходимые для каждой конкретной задачи. Skill может включать десятки справочных файлов, но если ваша задача требует только схемы продаж, Claude загружает только этот один файл. Остальные остаются в файловой системе, потребляя нулевые токены.

Эффективное выполнение скрипта: Когда Claude запускает validate_form.py, код скрипта никогда не загружается в окно контекста. Только вывод скрипта (например, "Validation passed" или конкретные сообщения об ошибках) потребляет токены. Это делает скрипты намного более эффективными, чем если бы Claude генерировал эквивалентный код на лету.

Нет практического ограничения на объединённое содержимое: поскольку файлы не потребляют контекст до доступа, Skills могут включать полную документацию API, большие наборы данных, обширные примеры или любые справочные материалы, которые вам нужны. Нет штрафа за контекст для объединённого содержимого, которое не используется.

Эта модель на основе файловой системы — это то, что делает возможным постепенное раскрытие. Claude навигирует по вашему Skill, как вы ссылались бы на конкретные разделы руководства по адаптации, получая доступ ровно к тому, что требует каждая задача.

Пример: загрузка skill обработки PDF

Вот как Claude загружает и использует skill обработки PDF:

1. Запуск: системная подсказка включает: PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Запрос пользователя: "Extract the text from this PDF and summarize it"
3. Claude вызывает: bash: read pdf-skill/SKILL.md → Инструкции загружены в контекст
4. Claude определяет: заполнение форм не требуется, поэтому FORMS.md не читается
5. Claude выполняет: использует инструкции из SKILL.md для выполнения задачи

Диаграмма показывает:

1. Состояние по умолчанию с системной подсказкой и предварительно загруженными метаданными skill
2. Claude срабатывает skill, читая SKILL.md через bash
3. Claude опционально читает дополнительные объединённые файлы, такие как FORMS.md, по мере необходимости
4. Claude переходит к выполнению задачи

Эта динамическая загрузка гарантирует, что только релевантное содержимое skill занимает окно контекста.

Где работают Skills

Skills доступны во всех продуктах агентов Claude:

Claude API

Claude API поддерживает как предварительно созданные Agent Skills, так и пользовательские Skills. Оба работают одинаково: укажите соответствующий skill_id в параметре container вместе с инструментом выполнения кода.

Предварительные условия: использование Skills через API требует три бета-заголовка:

• code-execution-2025-08-25 - Skills работают в контейнере выполнения кода
• skills-2025-10-02 - включает функциональность Skills
• files-api-2025-04-14 - требуется для загрузки/скачивания файлов в/из контейнера

Используйте предварительно созданные Agent Skills, ссылаясь на их skill_id (например, pptx, xlsx), или создавайте и загружайте свои собственные через Skills API (конечные точки /v1/skills). Пользовательские Skills совместно используются во всей организации.

Чтобы узнать больше, см. Использование Skills с Claude API.

Claude Code

Claude Code поддерживает только пользовательские Skills.

Пользовательские Skills: создавайте Skills как каталоги с файлами SKILL.md. Claude обнаруживает и использует их автоматически.

Пользовательские Skills в Claude Code основаны на файловой системе и не требуют загрузки через API.

Чтобы узнать больше, см. Использование Skills в Claude Code.

Claude.ai

Claude.ai поддерживает как предварительно созданные Agent Skills, так и пользовательские Skills.

Предварительно созданные Agent Skills: эти Skills уже работают за кулисами при создании документов. Claude использует их без требования какой-либо настройки.

Пользовательские Skills: загружайте свои собственные Skills как zip-файлы через Settings > Features. Доступно на планах Pro, Max, Team и Enterprise с включённым выполнением кода. Пользовательские Skills индивидуальны для каждого пользователя; они не совместно используются во всей организации и не могут быть централизованно управляемы администраторами.

Чтобы узнать больше об использовании Skills в Claude.ai, см. следующие ресурсы в Claude Help Center:

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Teach Claude your way of working using Skills

Структура Skill

Каждый Skill требует файл SKILL.md с YAML frontmatter:

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Обязательные поля: name и description

Требования к полям:

name:

• Максимум 64 символа
• Должно содержать только строчные буквы, цифры и дефисы
• Не может содержать XML-теги
• Не может содержать зарезервированные слова: "anthropic", "claude"

description:

• Должно быть непустым
• Максимум 1024 символа
• Не может содержать XML-теги

description должно включать как то, что делает Skill, так и когда Claude должен его использовать. Для полного руководства по авторству см. руководство лучших практик.

Соображения безопасности

Мы настоятельно рекомендуем использовать Skills только из надёжных источников: те, которые вы создали сами, или полученные от Anthropic. Skills предоставляют Claude новые возможности через инструкции и код, и хотя это делает их мощными, это также означает, что вредоносный Skill может направить Claude на вызов инструментов или выполнение кода способами, которые не соответствуют заявленной цели Skill.

Ключевые соображения безопасности:

• Тщательно проверьте: просмотрите все файлы, объединённые в Skill: SKILL.md, скрипты, изображения и другие ресурсы. Ищите необычные паттерны, такие как неожиданные сетевые вызовы, паттерны доступа к файлам или операции, которые не соответствуют заявленной цели Skill
• Внешние источники рискованны: Skills, которые получают данные из внешних URL-адресов, представляют особый риск, так как полученное содержимое может содержать вредоносные инструкции. Даже надёжные Skills могут быть скомпрометированы, если их внешние зависимости изменятся со временем
• Неправильное использование инструментов: вредоносные Skills могут вызывать инструменты (операции с файлами, команды bash, выполнение кода) вредоносными способами
• Раскрытие данных: Skills с доступом к конфиденциальным данным могут быть разработаны для утечки информации во внешние системы
• Относитесь как к установке программного обеспечения: используйте Skills только из надёжных источников. Будьте особенно осторожны при интеграции Skills в производственные системы с доступом к конфиденциальным данным или критическим операциям

Доступные Skills

Предварительно созданные Agent Skills

Следующие предварительно созданные Agent Skills доступны для немедленного использования:

• PowerPoint (pptx): создавайте презентации, редактируйте слайды, анализируйте содержимое презентации
• Excel (xlsx): создавайте электронные таблицы, анализируйте данные, генерируйте отчёты с диаграммами
• Word (docx): создавайте документы, редактируйте содержимое, форматируйте текст
• PDF (pdf): генерируйте отформатированные PDF-документы и отчёты

Эти Skills доступны на Claude API и claude.ai. См. руководство быстрого старта, чтобы начать использовать их в API.

Skills с открытым исходным кодом

Anthropic также публикует Skills с открытым исходным кодом в репозитории skills:

• Claude API: предоставляет Claude актуальный справочный материал API, документацию SDK и лучшие практики для 8 языков программирования. Включён в Claude Code и также доступен для установки из репозитория skills.

Примеры пользовательских Skills

Для полных примеров пользовательских Skills см. Skills cookbook.

Хранение данных

Agent Skills не охватывается соглашениями ZDR. Определения Skills и данные выполнения сохраняются в соответствии со стандартной политикой хранения данных Anthropic.

Для соответствия ZDR во всех функциях см. API и хранение данных.

Ограничения и ограничивающие факторы

Понимание этих ограничений помогает вам эффективно спланировать развёртывание Skills.

Доступность на разных поверхностях

Пользовательские Skills не синхронизируются между поверхностями. Skills, загруженные на одну поверхность, не автоматически доступны на других:

• Skills, загруженные в Claude.ai, должны быть отдельно загружены в API
• Skills, загруженные через API, недоступны в Claude.ai
• Claude Code Skills основаны на файловой системе и отделены от Claude.ai и API

Вам нужно управлять и загружать Skills отдельно для каждой поверхности, где вы хотите их использовать.

Область совместного использования

Skills имеют разные модели совместного использования в зависимости от того, где вы их используете:

• Claude.ai: только отдельный пользователь; каждый член команды должен загружать отдельно
• Claude API: рабочее пространство; все члены рабочего пространства могут получить доступ к загруженным Skills
• Claude Code: личные (~/.claude/skills/) или основанные на проекте (.claude/skills/); также могут быть совместно использованы через Claude Code Plugins

Claude.ai в настоящее время не поддерживает централизованное управление администратором или распределение Skills во всей организации.

Ограничения среды выполнения

Точная среда выполнения, доступная вашему skill, зависит от поверхности продукта, где вы её используете.

• Claude.ai:
  • Различный сетевой доступ: в зависимости от параметров пользователя/администратора, Skills могут иметь полный, частичный или отсутствующий сетевой доступ. Для получения дополнительной информации см. статью поддержки Create and Edit Files.
• Claude API:
  • Нет сетевого доступа: Skills не могут делать внешние вызовы API или получать доступ в Интернет
  • Нет установки пакетов во время выполнения: доступны только предварительно установленные пакеты. Вы не можете устанавливать новые пакеты во время выполнения.
  • Только предварительно настроенные зависимости: проверьте документацию инструмента выполнения кода для списка доступных пакетов
• Claude Code:
  • Полный сетевой доступ: Skills имеют тот же сетевой доступ, что и любая другая программа на компьютере пользователя
  • Глобальная установка пакетов не рекомендуется: Skills должны устанавливать пакеты только локально, чтобы избежать помех с компьютером пользователя

Спланируйте свои Skills для работы в этих ограничениях.

Следующие шаги