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 frontmatter навыка предоставляет информацию для обнаружения:

---
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 загружает эти метаданные при запуске и включает их в «system prompt» (системную подсказку). Поле description — это то, с чем 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).

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

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

Skills могут включать дополнительные материалы:

• pdf-processing/
  • SKILL.md (основные инструкции)
  • FORMS.md (руководство по заполнению форм)
  • REFERENCE.md (подробный справочник по API)
  • scripts/
    • fill_form.py (служебный скрипт)

Инструкции: дополнительные файлы 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.

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

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

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

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

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

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

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

Рекомендации по управлению, проверке и развёртыванию в масштабе организации см. в разделе Навыки для предприятий. Организации Claude Enterprise также могут включить сканирование содержимого навыков для пользовательских навыков, загружаемых в claude.ai и Claude Cowork. Сканирование не распространяется на навыки, загруженные через Skills API или Claude Console.

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

Готовые Agent Skills

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

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

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

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

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

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

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

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

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

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

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

О журналировании аудита операций Skills API см. раздел Журналирование аудита в документе «Использование Agent Skills с API».

Ограничения

Claude Platform on AWS и Microsoft Foundry подчиняются тем же ограничениям, что и Claude API, в следующих подразделах. Кроме того, в Microsoft Foundry не поддерживается конечная точка загрузки версии Skill (GET /v1/skills/{skill_id}/versions/{version}/content).

Доступность на разных платформах

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

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

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

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