Навыки агента



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

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

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

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



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

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

Готовые навыки агента доступны на claude.ai, в Claude API, на Claude Platform on AWS и в Microsoft Foundry. В Microsoft Foundry навыки агента требуют развёртывания 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. Только после этого содержимое попадает в контекстное окно.



Уровень 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 поддерживает как готовые навыки агента, так и пользовательские навыки. Оба типа работают идентично: укажите соответствующий skill_id в параметре container вместе с инструментом выполнения кода.

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

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

Используйте готовые навыки агента, ссылаясь на их 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 поддерживает как готовые навыки агента, так и пользовательские навыки.

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

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

Подробнее об использовании навыков на claude.ai см. в следующих ресурсах Центра поддержки Claude:

• Что такое навыки?
• Использование навыков в Claude
• Как создавать пользовательские навыки
• Научите Claude вашему стилю работы с помощью навыков



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

Каждый навык требует файла 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, выполнение кода) во вредоносных целях
• Раскрытие данных: навыки с доступом к конфиденциальным данным могут быть спроектированы для утечки информации во внешние системы
• Относитесь как к установке программного обеспечения: используйте навыки только из доверенных источников. Будьте особенно осторожны при интеграции навыков в производственные системы с доступом к конфиденциальным данным или критическим операциям



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



Готовые навыки агента

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

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

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



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

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

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



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

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



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

На навыки агента не распространяются соглашения 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:
  • Различный сетевой доступ: в зависимости от настроек пользователя/администратора навыки могут иметь полный, частичный сетевой доступ или не иметь его вовсе. Подробнее см. в статье поддержки Создание и редактирование файлов.
• Claude API:
  • Нет сетевого доступа: навыки не могут выполнять внешние вызовы API или получать доступ к интернету
  • Нет установки пакетов во время выполнения: доступны только предустановленные пакеты. Вы не можете устанавливать новые пакеты во время выполнения.
  • Только предварительно настроенные зависимости: список доступных пакетов см. в документации по инструменту выполнения кода
• Claude Code:
  • Полный сетевой доступ: навыки имеют тот же сетевой доступ, что и любая другая программа на компьютере пользователя
  • Глобальная установка пакетов не рекомендуется: навыки должны устанавливать пакеты только локально, чтобы не вмешиваться в работу компьютера пользователя

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



Дальнейшие шаги