Продолжаю обозревать скиллы для кодинг-агентов. Сегодня хотел разобрать ECC и ponytail
Но сначала разберем еще один момент - лимит, из-за которого установленный скилл может ни разу не сработать.
Коротко для тех, кто не в теме. Скилл это обычный текстовый файл с инструкцией: сверху имя и описание, ниже сама инструкция. Вы кладёте такой файл в папку, и агент подхватывает его сам, когда решит, что случай подходящий. Наборы вроде ECC или ponytail это пачки таких файлов, которые ставятся одной командой.
Если смотреть в более прикладном смысле - скилл это что то типа описания процесса/подпроцесса
Как это работает
Агент не читает вашу папку. При старте ему показывают список: имя и описание каждого скилла, по строке на скилл. Сам файл подгружается, только когда скилл позвали. Применять или нет, агент решает по описанию из этого списка.
У списка есть потолок в один процент контекстного окна. Для модели на 200 тысяч это 8 000 символов на все скиллы разом. Не влезло, и Claude Code выбрасывает описания, начиная с тех скиллов, которые вы зовёте реже. Имена остаются всегда, и скилл с одним именем агент фактически не выберет. Предупреждения нет: ни строки в логе, ни индикатора.
Кто в это уже упёрся. Человек выложил свои проекты: 25 скиллов, каждый по 490 символов, это внутри рекомендованных Anthropic 400-500, вместе 153% бюджета. Соседний проект: 56 скиллов покороче, 104%. Третий: 41 скилл, 82%, впритык. Дело не в количестве скиллов, а в сумме символов.
Плюс расход, о котором вы не просили: скиллы с claude.ai и из Cowork подтягиваются в сессию сами. У автора другого issue это 43 и 26 штук, 37% бюджета ещё до установки любого набора. Оба issue закрыты как «not planned».
Теперь к самому большому набору на слуху. Список ECC весит 71 126 символов, в девять раз больше выделенного бюджета. Описания сохранят 21 скилл, остальные 263 придут к агенту голыми именами. Так это сформулировал человек в issue самого ECC: «Скиллы, которые обрезало, нельзя выбрать. Они не низкоприоритетные, их нет.»
Спасает выборочная установка: минимальный профиль ECC это 44 скилла.
Обратный случай. ponytail в бюджет влезает легко, а в замере JetBrains за десять сессий не активировался сам ни разу. Сработал не скилл, а хук, который принудительно кладёт правила в контекст на старте сессии.
Проверить себя просто. /context покажет размер списка уже после обрезки, /doctor назовёт, кто съедает бюджет
Но сначала разберем еще один момент - лимит, из-за которого установленный скилл может ни разу не сработать.
Коротко для тех, кто не в теме. Скилл это обычный текстовый файл с инструкцией: сверху имя и описание, ниже сама инструкция. Вы кладёте такой файл в папку, и агент подхватывает его сам, когда решит, что случай подходящий. Наборы вроде ECC или ponytail это пачки таких файлов, которые ставятся одной командой.
Если смотреть в более прикладном смысле - скилл это что то типа описания процесса/подпроцесса
Как это работает
Агент не читает вашу папку. При старте ему показывают список: имя и описание каждого скилла, по строке на скилл. Сам файл подгружается, только когда скилл позвали. Применять или нет, агент решает по описанию из этого списка.
У списка есть потолок в один процент контекстного окна. Для модели на 200 тысяч это 8 000 символов на все скиллы разом. Не влезло, и Claude Code выбрасывает описания, начиная с тех скиллов, которые вы зовёте реже. Имена остаются всегда, и скилл с одним именем агент фактически не выберет. Предупреждения нет: ни строки в логе, ни индикатора.
Кто в это уже упёрся. Человек выложил свои проекты: 25 скиллов, каждый по 490 символов, это внутри рекомендованных Anthropic 400-500, вместе 153% бюджета. Соседний проект: 56 скиллов покороче, 104%. Третий: 41 скилл, 82%, впритык. Дело не в количестве скиллов, а в сумме символов.
Плюс расход, о котором вы не просили: скиллы с claude.ai и из Cowork подтягиваются в сессию сами. У автора другого issue это 43 и 26 штук, 37% бюджета ещё до установки любого набора. Оба issue закрыты как «not planned».
Теперь к самому большому набору на слуху. Список ECC весит 71 126 символов, в девять раз больше выделенного бюджета. Описания сохранят 21 скилл, остальные 263 придут к агенту голыми именами. Так это сформулировал человек в issue самого ECC: «Скиллы, которые обрезало, нельзя выбрать. Они не низкоприоритетные, их нет.»
Спасает выборочная установка: минимальный профиль ECC это 44 скилла.
Обратный случай. ponytail в бюджет влезает легко, а в замере JetBrains за десять сессий не активировался сам ни разу. Сработал не скилл, а хук, который принудительно кладёт правила в контекст на старте сессии.
Проверить себя просто. /context покажет размер списка уже после обрезки, /doctor назовёт, кто съедает бюджет