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

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

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

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

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

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

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

Готовые навыки агента доступны всем пользователям на claude.ai и через Claude API. Полный список см. в разделе Доступные навыки ниже.

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

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

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

Эта архитектура на основе файловой системы обеспечивает постепенное раскрытие: 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 Agent SDK

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

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

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

Подробнее см. в разделе Навыки агента в SDK.

Claude.ai

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

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

Пользовательские навыки: Загружайте собственные навыки в виде zip-файлов через Настройки > Функции. Доступно на планах 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.ai. См. руководство по быстрому старту, чтобы начать использовать их в API.

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

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

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

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

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

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

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