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

Структура скила: папка и SKILL.md✦

Скил (skill) — это модульная инструкция, которая подгружается в контекст агента по необходимости. По материалам доклада-онбординга (Сергей Будяев, Яндекс), структурно скил устроен предельно просто: это обычная папка с единственным обязательным файлом SKILL.md. Официальная документация Anthropic подтверждает это устройство.

Файл SKILL.md✦

SKILL.md состоит из двух частей:

  • YAML-фронтматтер с двумя обязательными полями — name и description. По документации Anthropic: name — до 64 символов (только строчные буквы, цифры и дефисы; без зарезервированных слов «anthropic»/«claude»); description — непустое, до 1024 символов, и должно описывать, что делает скил и когда его применять (именно по описанию агент решает, вызывать ли скил).
  • Тело в markdown — инструкции, шаги, правила и примеры для агента.

Прогрессивная загрузка контекста✦

Ключевая особенность, ради которой скилы и «стрельнули» (так формулирует докладчик), — поэтапная загрузка. Документация выделяет три уровня:

  1. Метаданные (name + description) грузятся всегда при старте — ~100 токенов на скил. Поэтому можно держать много скилов без засорения контекста. В докладе называется та же цифра — «до 100 токенов».
  2. Тело SKILL.md загружается только при срабатывании скила; рекомендуется держать его под ~5k токенов и менее 500 строк.
  3. Ресурсы (скрипты, референсы, ассеты) читаются по требованию, практически без ограничения объёма. Код скриптов в контекст вообще не попадает — агент получает только их вывод.

Самодостаточная единица✦

В ту же папку можно положить что угодно: вспомогательные скрипты, референсы на документацию и best practices, шаблоны, конфиги, дополнительные .md-файлы. Благодаря этому скил — самодостаточная история, не требующая ничего вокруг, и его удобно распространять целиком как одну папку (через каталоги скилов и утилиты установки). Документация при этом советует ссылаться на вложенные файлы не глубже одного уровня от SKILL.md, чтобы агент читал их целиком, а не урывками.

Источники✦