За несколько месяцев я поставил себе в Claude Code всё, что попадалось на глаза. Навык для A/B-тестов, для холодных писем, для Terraform, для анализа одноклеточного секвенирования. Каждый весил пару килобайт и выглядел полезным. К сентябрю в папке ~/.claude/skills лежало 254 навыка.
Потом я посмотрел логи и понял, что большинство из них ни разу не запускалось.
Немного контекста. Я работаю в Claude Code каждый день, и не только как программист. У меня Telegram-бот, через который в Claude приходят задачи по десяткам проектов: SEO, сайты, письма, отчёты, документы. Каждая задача запускает новую сессию. Поэтому всё, что Claude Code подгружает при старте, я оплачиваю по многу раз в день.
Что я нашёл в логах
Я выгрузил все сессии с 1 августа по 1 октября. Их было 662. Дальше простой вопрос: какие навыки модель реально вызывала?
Тринадцать. Их я и оставил: документы (docx, pdf, xlsx, pptx), отладку, проверку перед тем как сказать «готово», ревью кода, граф проекта, работу с браузером, конспект YouTube-ролика и навык, который чистит текст от канцелярита. Остальные 241 два месяца просто лежали.
Источник: автор статьи
Лежали они не бесплатно. Claude Code не читает все SKILL.md целиком, это правда. Но имя и описание каждого навыка модель видит в начале сессии, иначе она не поймёт, когда какой навык нужен. Я посчитал длину описаний: в среднем около 330 знаков, у 64 навыков больше 400. Один навык про миграции баз данных умудрился уложить в поле description 16 тысяч знаков. В сумме по архиву выходит больше 80 тысяч знаков описаний, и почти все они были про задачи, которых у меня нет.
Источник: автор статьи
Плюс второй эффект, менее заметный. Когда в списке 254 похожих описаний, модели сложнее выбрать нужное. Навыков про маркетинг, рекламу и конверсию у меня было под сорок, и они честно мешали друг другу.
Удалять жалко, держать дорого
Удалять я ничего не стал. Через месяц понадобится навык для юриста или для SQL, и искать навык заново будет обидно. Решение получилось такое.
Тринадцать рабочих навыков остались в ~/.claude/skills. Остальные 241 перенёс в соседнюю папку skills-archive, туда Claude Code сам не смотрит. Именно перенёс, а не удалил: если навык понадобится постоянно, его папку достаточно вернуть обратно.
Вместо 241 описания в активной папке появился один навык, skills-catalog. Внутри у него таблица: имя навыка, когда он нужен, путь к файлу. А описание короткое и написано так, чтобы модель вспоминала о каталоге в нужный момент:
--- name: skills-catalog description: Каталог архивных скиллов (маркетинг, SEO, продажи, финансы, юристы, данные, DevOps, базы данных, наука, контент, git, тестирование...). Открой, если задача требует специальной методики, которой нет среди активных скиллов; найди строку и прочитай файл скилла по пути. ---
Логика простая. Пока задача обычная, модель видит 14 описаний вместо 254. Если задача редкая, она открывает каталог, находит строку и читает нужный SKILL.md как обычный файл. Один лишний шаг, зато только тогда, когда он действительно нужен.
Источник: автор статьи
Описания тринадцати активных навыков вместе с каталогом занимают сейчас около 6,6 тысячи знаков. Было больше 80.
Проверил, что ничего не потерял
Экономия ничего не стоит, если модель перестанет находить нужное. Поэтому перед тем как оставить схему, я дал Claude десять задач, под которые активного навыка нет: спланировать A/B-тест, сделать SEO-аудит, написать холодное письмо, посчитать цены, разобрать отток клиентов, оптимизировать SQL-запрос, поправить Terraform, написать пост для LinkedIn, обработать данные scRNA, собрать документ Word с оглавлением. Во всех десяти случаях модель сама пошла в каталог и нашла подходящий навык.
Десять из десяти на маленькой выборке не доказательство на века. Но для личной системы этого хватило.
Как теперь добавляю новые навыки
Самое полезное, что я вынес из этой уборки, касается не старых навыков, а новых. Теперь большой пакет навыков я ставлю в два слоя.
Например, недавно мне понадобился набор из 13 навыков для коротких видео: хуки, сценарии, подписи, карусели. Пакет хороший, но написан под англоязычный Instagram. В активную папку я положил один лёгкий навык на 5 тысяч знаков. Он говорит модели: сначала прочитай файл с моим голосом и запретами, потом выбери нужный навык из архива и учти вот такие поправки. Например, что скрипты оценки хуков в пакете считают только английский текст, и для русского их запускать бесполезно. Сами 13 навыков лежат в архиве и подгружаются по одному, когда нужны.
Так же устроен пакет из 11 навыков для разбора и копирования чужих сервисов: в активной папке только вход на 4 тысячи знаков с порядком шагов.
Из этого вышло правило, которым я теперь проверяю каждый новый навык. Если за месяц я не вызвал его ни разу, ему место в архиве. Если вызываю постоянно, но он тянет за собой десяток соседей, наверх идёт один вход, а соседи ждут внизу.
Что я бы сделал с самого начала
Не ставил бы навыки пачками «на всякий случай». Каждый установленный навык это строчка, которую модель читает в каждой сессии, даже если вы ни разу им не пользовались.
Писал бы короткие description. Описание нужно не для того, чтобы рассказать про навык всё. Оно нужно, чтобы модель поняла, когда его открыть. Две-три фразы о том, на какие задачи и слова он срабатывает, работают лучше страницы текста.
Раз в месяц смотрел бы логи. У меня одна такая проверка убрала из каждого запуска десятки тысяч знаков, которые никто не читал.
Если вы только начинаете разбираться, как устроены навыки, что лежит в SKILL.md и как Claude решает, какой навык открыть, у нас в AI University есть разбор на русском: Claude Skills: что это и как установить. А официальный курс Anthropic про Agent Skills мы перевели целиком, с субтитрами: Введение в Agent Skills.
А у вас сколько навыков стоит и сколько из них реально запускается? Интересно, у кого получилось хуже, чем 13 из 254.
Изображение на обложке: автор статьи
Комментарии