Глоссарий
References: справочники скилла за пределом основного файла
Коротко: References — подкаталог скилла для справочных материалов: таблиц, длинных примеров, дампов команд и исторических разборов. Стандарт Agent Skills держит основной SKILL.md в пределах 500 строк, чтобы агент не сжигал контекст на том, что нужно раз в год. В основном файле остаётся ядро процедуры, а каждая вынесенная секция помечается ссылкой и условием: когда агенту читать этот файл. References проверяют тем же качеством, что и основной файл: битая ссылка или устаревшая таблица хуже отсутствующего файла.
Разнос длинного скилла на references это не про красоту, а про контекст: агент платит токенами за каждую строку, которую загружает. Основной файл должен отвечать на вопрос «что делать», а справочники на вопрос «как именно, с деталями».
Переносить секции лучше детерминированным скриптом: границы предлагает модель, блоки двигает код и построчно проверяет, что каждая строка доехала дословно. Пересказ модели в скилле равен потере команд и путей.