Библиотека из полусотни skills не тормозит агента сама по себе — так задумано в progressive disclosure. Проблема начинается, когда часть файлов молча деградирует: раздувается сверх разумного бюджета токенов, или тихо полагается на Claude-специфичные поля в общем репозитории команды.
Почему один хороший файл не гарантирует здоровье всей библиотеки
Проверка одного SKILL.md ничего не говорит о состоянии остальных сорока девяти. Реальный вопрос при периодическом аудите — сколько файлов в библиотеке превышают токен-бюджет, и сколько используют функциональность, недоступную в других агентах команды.
Два признака, за которыми стоит следить
---
name: deploy-helper
description: Handles deployment workflows
allowed-tools: [bash, read]
---Первый признак — Claude-специфичные поля вроде allowed-tools, context, hooks, которые молча игнорируются в Codex CLI, Gemini CLI и других агентах. Второй — объём тела skill, превышающий неформальный ориентир сообщества в пятьсот токенов.
| Проблема | Как проявляется | Что делать |
|---|---|---|
| Claude-специфичное поле | Работает только в Claude Code | Документировать или убрать для переносимости |
| Раздутое тело | Расходует контекст даже при редком использовании | Вынести в reference-файлы |
| Отсутствие description | Skill не подгружается по совпадению | Добавить чёткое описание сценария |
Практика периодического аудита
Разумная частота — раз в квартал или при добавлении заметного числа новых skills через Pull Request. Проверка не заменяет код ревью каждого конкретного файла, а даёт общую картину состояния всей библиотеки разом.
Как ускорить проверку большой библиотеки
Прогонять каждый файл по одному через одиночный валидатор долго при полусотне skills. SKILL.md Directory Batch Auditor проверяет всю папку одним проходом со сводной таблицей замечаний.
Итоговый чеклист
Периодический аудит библиотеки skills важнее разовой проверки одного файла — качество отдельных skills не гарантирует здоровье всей коллекции.
Claude-специфичные поля и превышение токен-бюджета — два самых частых признака деградации, за которыми стоит следить регулярно.
Пакетная проверка всей папки разом эффективнее ручного прогона каждого файла по отдельности при заметном размере библиотеки.