Перейти к содержанию

Skills (навыки агентов): концепция и прогрессивная загрузка✦

Skills (навыки агентов): концепция и прогрессивная загрузка✦

Доклад, которым поделился коллега (по его словам — отличный онбординг-доклад про скилы с богатым практическим опытом докладчика из Яндекса), даёт короткое и точное определение: скил — это модульная инструкция, загружаемая в контекст по необходимости. Именно это «по необходимости» (progressive disclosure, или прогрессивная/постепенная загрузка) и есть главное отличие скилов от обычных промтов.

Структура✦

Скил — это просто папка с одним обязательным файлом SKILL.md. В нём YAML front-matter с обязательными полями name и description, а ниже — тело инструкции: шаги, правила, примеры. Кроме того, в папку можно положить что угодно: скрипты, референсы, шаблоны, конфиги. Получается самодостаточная единица, которую удобно распространять целиком. Официальная документация Anthropic подтверждает: обязательны только name (до 64 символов, строчные буквы/цифры/дефисы) и description (непустое, до 1024 символов).

Три уровня загрузки✦

  1. При старте в контекст попадают только имя и описание скила — Anthropic рекомендует укладываться примерно в 100 токенов на скил. Благодаря этому можно держать много скилов, не засоряя контекст.
  2. При срабатывании триггера (запрос пользователя совпал с описанием) агент читает тело SKILL.md — ориентир до ~5000 токенов.
  3. Скрипты, референсы и шаблоны подгружаются только тогда, когда инструкция явно к ним обращается; объём здесь практически не ограничен, а код скриптов в контекст вообще не попадает — туда идёт только их вывод.

Эти три уровня и цифры из доклада совпадают с официальной документацией Anthropic. В этом и контраст с MCP или «правилами», которые во многих агентах грузятся в контекст сразу и целиком.

Практика из опыта команды✦

Докладчик советует «скилизовать» рутину и экспертизу: синхронизацию кодовых баз, снятие фиче-флагов, написание релиз-нотов, работу с таск-трекером. Отдельный приём — скил поверх MCP: MCP даёт лишь список тулов, а скил добавляет знание ваших сценариев и нюансов (какие списки, теги, ограничения). Вызвать скил можно тремя способами: агент сам по описанию, через /-команду или просто по имени текстом. Создавать — вручную, попросив агента или через готовый skill-creator; качество стоит проверять евалами (в т.ч. сравнением «со скилом / без скила»).

По наблюдению докладчика, Claude понимает скилы только в собственной папке .claude/skills, и это он считает минусом: при переключении между агентами или в команде с разными агентами удобнее более универсальное расположение, которое поддерживают Codex, OpenCode и Cursor. Это его личная оценка из практики; формат Agent Skills при этом — открытый стандарт, который, по данным внешних источников, уже принят рядом инструментов.

Источники✦