Agent Skills



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

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

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

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



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

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

Готовые Agent Skills доступны на claude.ai, в Claude API, на Claude Platform на AWS и в Microsoft Foundry. В Microsoft Foundry для Agent Skills требуется развёртывание Hosted on Anthropic. Полный список см. в разделе Доступные Skills.

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



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

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

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

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 загружает эти метаданные при запуске и включает их в системную подсказку. Поле description — это то, с чем Claude сопоставляет ваш запрос при определении, следует ли активировать Skill, поэтому оно должно указывать и что делает Skill, и когда его использовать. Этот легковесный подход означает, что вы можете установить много Skills без штрафа по контексту: пока 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-processing/
├── 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, большие наборы данных или обширные примеры. Нет штрафа по контексту за включённый контент, который не используется.



Пример: Загрузка Skill для обработки PDF

Вот как Claude загружает и использует пользовательский Skill pdf-processing из предыдущих примеров (не готовый Skill pdf):

1. Запуск: Системная подсказка включает: pdf-processing - 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.
2. Запрос пользователя: «Извлеки текст из этого PDF и сделай краткое изложение»
3. Claude вызывает: bash: cat pdf-processing/SKILL.md → Инструкции загружены в контекст
4. Claude определяет: Заполнение форм не требуется, поэтому FORMS.md не читается
5. Claude выполняет: Использует инструкции из SKILL.md для выполнения задачи



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

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



Claude API

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

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

• skills-2025-10-02 — включает функциональность Skills

Добавьте второй заголовок, files-api-2025-04-14, когда вы используете Files API для загрузки входных файлов в контейнер или скачивания файлов, которые создаёт Skill.

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

Skills в API выполняются в изолированном контейнере без доступа к сети и без установки пакетов во время выполнения. Подробности см. в разделе Ограничения и рамки.

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



Claude Code

Claude Code поддерживает пользовательские Skills. Готовые Skills для документов (PowerPoint, Excel, Word, PDF) недоступны в Claude Code, однако открытый Claude API skill поставляется вместе с ним. См. полный список встроенных команд и Skills, поставляемых с Claude Code.

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

Пользовательские Skills в Claude Code основаны на файловой системе и не требуют загрузки через API: поместите их в ~/.claude/skills/ (личные) или .claude/skills/ (проектные).

Чтобы узнать больше, см. Использование 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:

• Что такое Skills?
• Использование Skills в Claude
• Как создавать пользовательские Skills
• Научите Claude вашему способу работы с помощью 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.



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

Используйте 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 Platform на AWS, в Microsoft Foundry и на claude.ai. См. учебник по быстрому старту, чтобы начать использовать их в API.



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

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

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



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

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



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

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

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



Ограничения и рамки

Claude Platform на AWS и Microsoft Foundry следуют тем же ограничениям, что и Claude API, в следующих подразделах.



Доступность между поверхностями

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

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

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



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

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

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

claude.ai не поддерживает централизованное администрирование или распространение пользовательских Skills в масштабе организации.



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

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

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

Планируйте свои Skills так, чтобы они работали в рамках этих ограничений.



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