Agent Skills
Agent Skills — это модульные возможности, расширяющие функциональность Claude. Каждый навык объединяет инструкции, метаданные и необязательные ресурсы (скрипты, шаблоны), которые Claude автоматически использует, когда это уместно.
Использование зависит от продукта
type и skill_id каждого навыка в container.skills и включите инструмент выполнения кода, в контейнере которого выполняются навыки.skills агента или загружайте их из репозитория GitHub, смонтированного в сессии.Зачем использовать навыки
«Skills» (навыки) — это многократно используемые ресурсы на основе файловой системы, которые дают Claude экспертизу в конкретной предметной области: рабочие процессы, контекст и лучшие практики, превращающие агента общего назначения в специалиста. В отличие от подсказок (инструкций уровня разговора для одноразовых задач), навыки загружаются по требованию, поэтому вам не нужно повторять одни и те же указания в разных разговорах.
Ключевые преимущества:
- Специализация Claude: адаптируйте возможности под задачи конкретной предметной области
- Меньше повторений: создайте один раз, используйте автоматически
- Компоновка возможностей: комбинируйте навыки для сложных многоэтапных задач
Использование навыков
Anthropic предоставляет готовые Agent Skills для распространённых задач работы с документами (PowerPoint, Excel, Word, PDF), а также вы можете создавать собственные пользовательские навыки. Оба варианта работают одинаково: как только навык становится доступен в вашей среде, Claude автоматически использует его, когда он релевантен вашему запросу.
Готовые Agent Skills доступны в claude.ai, Claude API и на некоторых облачных платформах. Список навыков см. в разделе Доступные навыки.
Пользовательские навыки позволяют упаковать экспертизу в предметной области и знания организации. Создавайте их в Claude Code, загружайте через Skills API или добавляйте в настройках claude.ai.
Как работают навыки
Навыки используют среду виртуальной машины 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 обращается к этим файлам только тогда, когда на них есть ссылка. Модель файловой системы означает, что у каждого типа содержимого свои сильные стороны: инструкции — для гибких указаний, код — для надёжности, ресурсы — для поиска фактов.
| Уровень | Когда загружается | Стоимость в токенах | Содержимое |
|---|---|---|---|
| Уровень 1: Метаданные | Всегда (при запуске) | ~100 токенов на Skill | name и description из YAML frontmatter |
| Уровень 2: Инструкции | При срабатывании Skill | Менее 5 тыс. токенов | Тело SKILL.md с инструкциями и рекомендациями |
| Уровень 3+: Ресурсы | По мере необходимости | Нет, пока не запрошены | Входящие в комплект файлы. Справочные файлы загружаются в контекст при чтении. Скрипты выполняются через bash, и в контекст попадает только их вывод. |
Постепенное раскрытие гарантирует, что в любой момент времени контекстное окно занимает только релевантное содержимое.
Архитектура 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):
- Запуск: системная подсказка включает:
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. - Запрос пользователя: «Извлеки текст из этого PDF и кратко изложи его».
- Claude вызывает:
bash: cat pdf-processing/SKILL.md→ инструкции загружаются в контекст. - Claude определяет: заполнение форм не требуется, поэтому Claude не считывает
FORMS.md. - Claude выполняет задачу: использует инструкции из
SKILL.md.
Где работают Skills
Skills доступны во всех агентных продуктах Claude. О Skills в Claude Managed Agents см. на странице Навыки.
Сведения о Claude API на этой странице также применимы к облачным платформам, предлагающим Skills. Об исключениях см. в разделе Область общего доступа и в записи вашей платформы в разделе Доступность.
Claude API
Claude API поддерживает как готовые Agent Skills, так и пользовательские Skills. Оба варианта работают одинаково: укажите type и skill_id каждого Skill в container.skills.
Предварительные требования: для использования Skills через API требуется инструмент выполнения кода, в контейнере которого выполняются Skills.
Используйте готовые Agent Skills, ссылаясь на их skill_id (pptx, xlsx, docx или pdf), или создавайте и загружайте собственные через Skills API (конечные точки /v1/skills). О том, как предоставляется общий доступ к пользовательским Skills, см. в разделе Область общего доступа.
Skills в API выполняются в изолированном контейнере без доступа к сети и без возможности установки пакетов во время выполнения. Подробности см. в разделе Ограничения.
Подробнее см. в разделе Использование Agent Skills с API.
Claude Code
Claude Code поддерживает пользовательские Skills. Готовые Skills для документов (PowerPoint, Excel, Word, PDF) недоступны в Claude Code, однако в его комплект входит навык Claude API с открытым исходным кодом. См. полный список встроенных команд и 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-файлов. Доступно в планах Pro, Max, Ultra, Team и Enterprise с включённым выполнением кода.
Чтобы узнать больше об использовании 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 следует его использовать. Полное руководство по созданию см. в разделе Лучшие практики создания навыков.
Соображения безопасности
Используйте Skills только из надёжных источников: созданные вами самостоятельно или полученные от Anthropic. Skills предоставляют Claude новые возможности с помощью инструкций и кода, а это также означает, что вредоносный Skill может заставить Claude вызывать инструменты или выполнять код способами, не соответствующими заявленному назначению Skill.
Ключевые соображения безопасности:
- Тщательная проверка: просмотрите все файлы, входящие в Skill:
SKILL.md, скрипты, изображения и другие ресурсы. Обращайте внимание на необычные шаблоны, такие как неожиданные сетевые вызовы, шаблоны доступа к файлам или операции, не соответствующие заявленному назначению Skill. - Внешние источники сопряжены с риском: Skills, получающие данные с внешних URL-адресов, представляют особый риск, поскольку полученное содержимое может содержать вредоносные инструкции. Даже надёжные Skills могут быть скомпрометированы, если их внешние зависимости со временем изменятся.
- Неправомерное использование инструментов: вредоносные Skills могут вызывать инструменты (файловые операции, команды bash, выполнение кода) во вред.
- Раскрытие данных: Skills с доступом к конфиденциальным данным могут быть созданы для утечки информации во внешние системы.
- Относитесь как к установке программного обеспечения: будьте особенно осторожны при интеграции Skills в производственные системы с доступом к конфиденциальным данным или критически важным операциям.
Рекомендации по управлению, проверке и развёртыванию в масштабе организации см. в разделе Навыки для предприятий. Организации Claude Enterprise также могут включить сканирование содержимого навыков для пользовательских навыков, загружаемых в claude.ai и Claude Cowork. Сканирование не распространяется на навыки, загруженные через Skills API или Claude Console.
Доступные навыки
Готовые Agent Skills
Следующие готовые Agent Skills доступны для немедленного использования:
- PowerPoint (pptx): создание презентаций, редактирование слайдов, анализ содержимого презентаций
- Excel (xlsx): создание электронных таблиц, анализ данных, генерация отчётов с диаграммами
- Word (docx): создание документов, редактирование содержимого, форматирование текста
- PDF (pdf): генерация форматированных PDF-документов и отчётов
Чтобы начать их использовать, см. Начало работы с Agent Skills в API.
Навыки с открытым исходным кодом
Anthropic также публикует навыки с открытым исходным кодом в репозитории skills:
- Навык Claude API: предоставляет Claude актуальные справочные материалы по API, документацию SDK и лучшие практики для восьми языков программирования. Поставляется вместе с Claude Code, а также доступен для установки из репозитория skills.
Примеры пользовательских навыков
Полные примеры пользовательских Skills см. в Agent Skills Cookbook.
Хранение данных
На Agent Skills не распространяются соглашения ZDR. Определения навыков и данные выполнения хранятся в соответствии со стандартной политикой хранения данных Anthropic.
О журналировании аудита операций Skills API см. раздел Журналирование аудита в документе «Использование Agent Skills с API».
Ограничения
Проверьте эти ограничения, прежде чем создавать Skill или делиться им. На облачной платформе также проверьте запись вашей платформы в разделе Доступность на предмет ограничений размещения или конечных точек.
Доступность на разных платформах
Пользовательские навыки не синхронизируются между платформами. Навыки, загруженные на одну платформу, не становятся автоматически доступными на других:
- Skills, загруженные в claude.ai, необходимо отдельно загрузить в API.
- Skills, загруженные через API, недоступны в claude.ai.
- Skills в Claude Code основаны на файловой системе и отделены как от claude.ai, так и от API.
Управляйте навыками и загружайте их отдельно для каждой платформы, где вы хотите их использовать.
Область общего доступа
У навыков разные модели общего доступа в зависимости от того, где вы их используете:
- Claude API: всё рабочее пространство. Все участники рабочего пространства имеют доступ к загруженным навыкам.
- Claude Code: личные (
~/.claude/skills/) или проектные (.claude/skills/). Также могут распространяться через плагины Claude Code. - Claude Models on Google Cloud (Anthropic managed): каждый Skill принадлежит одному рабочему пространству. Роль IAM применяется ко всем рабочим пространствам в проекте Google Cloud, поэтому рабочие пространства не разграничивают, кто может читать, использовать Skills или управлять ими. Для раздельного доступа используйте отдельные проекты, как описано в разделе Рабочие пространства документации Claude Models on Google Cloud (Anthropic managed).
Ограничения среды выполнения
Точная среда выполнения, доступная вашему навыку, зависит от продуктовой платформы, на которой вы его используете.
- claude.ai:
- Различный сетевой доступ: в зависимости от настроек пользователя или администратора Skills могут иметь полный, частичный сетевой доступ или не иметь его вовсе. Подробнее см. в статье поддержки Создание и редактирование файлов с помощью Claude.
- Claude API:
- Нет сетевого доступа: Skills не могут выполнять внешние вызовы API или получать доступ к интернету.
- Нет установки пакетов во время выполнения: доступны только предустановленные пакеты. Вы не можете устанавливать новые пакеты во время выполнения.
- Только предварительно настроенные зависимости: список доступных пакетов см. в документации по инструменту выполнения кода.
- Claude Code:
- Полный сетевой доступ: Skills имеют такой же сетевой доступ, как и любая другая программа на компьютере пользователя.
- Глобальная установка пакетов не рекомендуется: Skills должны устанавливать пакеты только локально, чтобы не влиять на работу компьютера пользователя.
Планируйте свои навыки так, чтобы они работали в рамках этих ограничений.
Следующие шаги
Узнайте, как использовать Agent Skills для создания документов с помощью Claude API менее чем за 10 минут.
Узнайте, как использовать Agent Skills для расширения возможностей Claude через API.
Создавайте пользовательские навыки и управляйте ими в Claude Code.
Узнайте, как писать эффективные навыки, которые Claude сможет обнаруживать и успешно использовать.
Доступность
Claude API
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Claude Platform on AWS
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Claude Models on Google Cloud (Anthropic managed)
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Microsoft Foundry (hosted on Anthropic)
- API
- Messages API
- Модели
- Все модели
- Примечание
Только развёртывания, размещённые в Anthropic; эндпоинт скачивания версии навыка (
GET /v1/skills/{skill_id}/versions/{version}/content) не поддерживается в Foundry.
Обработка данных
Обзор обработки данныхПрименимые конечные точки
/v1/skills/v1/messagesсskills
Данные навыков хранятся в соответствии со стандартной политикой. Подробнее
Эта страница была полезной?