Claude Platform Docs
СообщенияНавыки

Agent Skills

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

Использование зависит от продукта

Messages API
Укажите type и skill_id каждого навыка в container.skills и включите инструмент выполнения кода, в контейнере которого выполняются навыки.
Managed Agents
Подключайте навыки в массиве 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 токенов на Skillname и description из YAML frontmatter
Уровень 2: ИнструкцииПри срабатывании SkillМенее 5 тыс. токеновТело SKILL.md с инструкциями и рекомендациями
Уровень 3+: РесурсыПо мере необходимостиНет, пока не запрошеныВходящие в комплект файлы. Справочные файлы загружаются в контекст при чтении. Скрипты выполняются через bash, и в контекст попадает только их вывод.

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

Архитектура Skills

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

Агент + Skills + Компьютер
Основная системная подсказка
bigquerydocxnda-reviewpdfpptxxlsx
Сервер MCP ⁠1
Сервер MCP ⁠2
Сервер MCP ⁠3
Сервер MCP ⁠1
Сервер MCP ⁠2
Сервер MCP ⁠3
использует компьютер
BashPythonNodejs
Каталоги Skills хранятся в ⁠файловой системе компьютера агента
skills/bigquery/SKILL.mddatasources.mdrules.mdskills/docx/SKILL.mdooxml/spec.mdediting.mdskills/nda-review/SKILL.mdskills/pdf/SKILL.mdforms.mdreference.mdextract_fields.py

Как 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 определяет: заполнение форм не требуется, поэтому Claude не считывает FORMS.md.
  5. Claude выполняет задачу: использует инструкции из SKILL.md.
Skills и ⁠контекстное окно
<...contents of the agent’s core system prompt...>
Короткие фрагменты каждого Skill, добавленные в ⁠системную подсказку
bigquerydocxnda-reviewpdfpptxxlsx
Первое сообщение пользователя
User: Fill out this PDF based on what you know about meAttached: /mnt/uploads/order_form.pdf
Claude решает «активировать» Skill для PDF, прочитав его
Claude: Certainly! I’ll use the PDF Skill to helpTool use: Bash (”cat /mnt/skills/pdf/SKILL.md”)
Tool result: {stdout: “...contents of the SKILL.md file...”}
Claude решает перейти по ссылке из SKILL.md на файл forms.md
Tool use: Bash (”cat /mnt/skills/pdf/forms.md”)
Tool result: {stdout: “...contents of the forms.md file...”}

Где работают 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:

Структура 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 сможет обнаруживать и успешно использовать.

Доступность

Agent Skills
API
  • Messages API
  • Managed Agents
Модели
  • Все модели

Обработка данных

Обзор обработки данных

Применимые конечные точки

  • /v1/skills
  • /v1/messages с skills
Нулевое хранение данныхНе допускается

Данные навыков хранятся в соответствии со стандартной политикой. Подробнее

HIPAAНе допускается

Эта страница была полезной?