Agent Skills



Зачем использовать навыки

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

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

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



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

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

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

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



Как работают навыки

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

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



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

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



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

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

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



Уровень 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).

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



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

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

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

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



Архитектура навыков

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

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

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

Что даёт эта архитектура:

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

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

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

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



Пример: загрузка навыка обработки PDF

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

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

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

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

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



Где работают навыки

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



Claude API

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

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

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

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

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



Claude Code

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

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

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

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



claude.ai

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

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

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

Чтобы узнать больше об использовании навыков в claude.ai, см. следующие ресурсы в Справочном центре Claude:

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



Структура навыка

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



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

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

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

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



Доступные навыки



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

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

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

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



Навыки с открытым исходным кодом

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

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



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

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



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

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

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



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

Понимание этих ограничений поможет вам эффективно спланировать развёртывание навыков. Claude Platform on AWS и Microsoft Foundry следуют тем же ограничениям, что и Claude API, в следующих подразделах.



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

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

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

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



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

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

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

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



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

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

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

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



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