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 используют виртуальную машину Claude для предоставления возможностей, которые невозможны только с подсказками. Claude работает на виртуальной машине с доступом к файловой системе, позволяя Skills существовать как каталогам, содержащим инструкции, исполняемый код и справочные материалы, организованные как руководство по адаптации, которое вы создали бы для нового члена команды.

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

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

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

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

Тип содержимого: Инструкции. Фронтматтер 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 Agent SDK

Claude Agent SDK поддерживает пользовательские Skills через конфигурацию на основе файловой системы.

Пользовательские Skills: Создавайте Skills как каталоги с файлами SKILL.md в .claude/skills/. Включите Skills, включив "Skill" в конфигурацию allowed_tools.

Skills в Agent SDK затем автоматически обнаруживаются при запуске SDK.

Чтобы узнать больше, см. Agent Skills в SDK.

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:

---
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

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

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

Понимание этих ограничений помогает вам эффективно спланировать развёртывание 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 для работы в этих ограничениях.

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