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

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

Навыки — это переиспользуемые ресурсы на основе файловой системы, которые предоставляют 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. Запрос пользователя: "Extract the text from this PDF and summarize it"
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), или создавайте и загружайте свои собственные через 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-файлы через Settings > Features. Доступно на планах Pro, Max, Team и Enterprise с включённым выполнением кода. Пользовательские навыки индивидуальны для каждого пользователя; они не используются во всей организации и не могут управляться централизованно администраторами.

Для получения дополнительной информации об использовании навыков в Claude.ai см. следующие ресурсы в центре справки Claude:

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Tech 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, выполнение кода) вредоносными способами
• Раскрытие данных: навыки с доступом к конфиденциальным данным могут быть разработаны для утечки информации во внешние системы
• Относитесь как к установке программного обеспечения: используйте навыки только из надёжных источников. Будьте особенно осторожны при интеграции навыков в производственные системы с доступом к конфиденциальным данным или критическим операциям

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

Предварительно созданные навыки агента

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

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

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

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

Для полных примеров пользовательских навыков см. Cookbook навыков.

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

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

Доступность на разных поверхностях

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

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

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

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

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

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

Claude.ai в настоящее время не поддерживает централизованное управление администратором или распределение навыков на уровне организации.

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

Навыки работают в контейнере выполнения кода со следующими ограничениями:

• Нет доступа в сеть: навыки не могут делать внешние вызовы API или получать доступ в Интернет
• Нет установки пакетов во время выполнения: доступны только предварительно установленные пакеты. Вы не можете устанавливать новые пакеты во время выполнения.
• Только предварительно настроенные зависимости: проверьте документацию инструмента выполнения кода для списка доступных пакетов

Спланируйте свои навыки для работы в этих ограничениях.

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