Skills - это способ закрепить поведение Anthropic Claude в виде переиспользуемых модулей. Вместо повторного объяснения задачи в каждом диалоге создаётся отдельный пакет с инструкциями, который автоматически подключается при подходящем запросе.
Что такое Skill
Skill представляет собой простую структуру: папку с файлом SKILL.md. Внутри файла находятся два ключевых блока - описание и инструкции. Описание определяет, когда именно навык должен использоваться, а инструкции задают поведение модели.
Такой подход позволяет вынести знания и процессы за пределы конкретного чата. Один раз описанный сценарий применяется во всех последующих взаимодействиях без повторной настройки.
Принцип работы
Claude не загружает все навыки сразу. Он выбирает их на основе описания, сопоставляя его с текущим запросом пользователя. Это делает описание критически важной частью skill.
Если описание слишком общее, навык будет срабатывать слишком часто. Если слишком узкое он может не использоваться вообще. В документе отдельно подчёркивается, что именно баланс в описании определяет эффективность навыка.
Инструкции внутри skill работают как постоянный системный промпт. Они не зависят от текущего диалога и применяются одинаково каждый раз.
Структура SKILL.md
Файл делится на YAML-блок и основной текст.
YAML-блок содержит имя и описание. Это метаданные, которые управляют активацией навыка.
Основной текст это последовательность инструкций. В нём задаётся стиль, шаги выполнения и ограничения.
Пример базовой структуры:
---
name: weekly-client-update
description: Generates weekly client updates when user asks for status summaries
---
Write updates in a concise, professional tone.
Include key metrics, blockers, and next steps.Проектирование навыка
Перед созданием skill определяется задача, которую он должен решать. В руководстве навык рассматривается как аналог инструкции для нового сотрудника: он должен быть понятным, воспроизводимым и не требовать уточнений.
Важно не перегружать навык лишними деталями. Простота рассматривается как ключевой принцип. Skills намеренно сделаны в виде обычных markdown-файлов, чтобы их было легко создавать и распространять.
Прогрессивное раскрытие
В инструкции от Anthropic описан механизм, при котором Claude использует только ту часть навыка, которая нужна в текущем контексте. Это снижает нагрузку и делает поведение более точным.
Навык не обязан быть минимальным. Он может содержать сложные инструкции, но модель будет применять их частично, в зависимости от задачи.
Триггеры и описание
Описание skill выполняет роль триггера. Оно должно включать формулировки, которые совпадают с реальными пользовательскими запросами.
Например, если навык должен писать отчёты, в описании должны присутствовать слова вроде "report", "summary", "update". Это повышает вероятность его активации.
Ошибки в описании приводят к двум основным проблемам: навык активируется слишком часто или не активируется вовсе.
Примеры skills
Skill для написания отчётов:
---
name: project-report-writer
description: Writes structured project reports when user asks for summaries or reports
---
Write in formal tone.
Structure the report into overview, progress, risks, and next steps.
Avoid unnecessary details.Skill для обработки логов:
---
name: log-analyzer
description: Analyzes logs and identifies errors or anomalies
---
Extract errors and warnings.
Group similar issues.
Highlight critical failures first.
Provide short explanation for each issue.Skill для генерации кода:
---
name: api-endpoint-generator
description: Generates backend API endpoints based on user requirements
---
Use clean architecture principles.
Include validation and error handling.
Return production-ready code.Паттерны проектирования
Нужно учитывать повторяющиеся подходы к созданию навыков. Они описывают, как структурировать инструкции для разных типов задач.
Один из ключевых паттернов это разделение логики на этапы. Вместо одного длинного описания задача разбивается на последовательные шаги внутри инструкции.
Другой паттерн это фиксация стиля. Навык может задавать строгие правила оформления текста или кода, которые будут соблюдаться автоматически.
Тестирование и итерации
После создания skill его необходимо проверять в реальных сценариях. Основной критерий это корректность срабатывания и качество результата.
Если навык активируется не там, где нужно, корректируется описание. Если результат не соответствует ожиданиям, изменяются инструкции.
Процесс итеративный: skill постепенно дорабатывается на основе наблюдений.
Распространение
Skills можно использовать локально или распространять как отдельные пакеты. Поскольку формат открыт и основан на простых файлах, они могут применяться в разных системах и агентах.
Это делает skills универсальным механизмом для передачи знаний и рабочих процессов между пользователями и командами.
Источник: Anthropic