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

Claude Code

Спящий уровень навыков: 2 544 токена ужались до 338

5 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: Claude Code: версии и изменения →
Изображение: pexels.com

Разработчик под ником danielLublinsky 14 августа выложил плагин Skill Atlas для Claude Code (репозиторий на Github), который добавляет навыкам третий режим между «включён» и «выключен»: описание навыка не попадает в контекст, но Claude находит навык поиском, когда он нужен. На коллекции автора из 53 навыков, где включёнными оставлены 6, стартовая нагрузка сессии упала с 2 544 до 338 токенов, на 86,7%.

Остальные 47 навыков ничего не стоят, пока их не ищут.

Зачем третий уровень

Claude Code вставляет описание каждого включённого навыка в каждую сессию, по подсчёту автора около 48 токенов на навык. В сторонних руководствах оценки этих метаданных разные: от 30-50 до примерно 100 токенов на навык. Без описаний навыки не работают: Claude сам решает, какой навык запустить, сравнивая запрос с их описаниями, и навык с расплывчатым описанием просто не срабатывает. Тело навыка, как сказано в документации Claude Code, загружается только при использовании, так что постоянно вы платите именно за описания. В той же документации упомянута проверка /doctor: она показывает неиспользуемые навыки, MCP-серверы и плагины рядом с тем, сколько контекста они занимают.

По словам автора, при сотне с лишним навыков это тысячи токенов в каждой сессии, а похожие описания ещё и незаметно соперничают за внимание модели. Если навык отключить, он перестаёт стоить токены, но и найти его Claude уже не сможет. Отсюда схема из трёх уровней:

  • включённый: описание в контексте, Claude вызывает навык штатно, около 48 токенов за сессию на навык;
  • searchable, «спящий»: в контексте его нет, находится через skill-search, ноль токенов;
  • отключённый: в контексте его нет, найти нельзя, ноль токенов.

Весь спящий уровень в начале сессии обозначен всего одной строкой примерно на 50 токенов. Навыки между уровнями переносит команда /skill-atlas:edit-searchable.

Два файла вместо каталога

Поиск не читает каталог целиком. Сначала Claude открывает индекс _index.md из 14 строк, около 1 600 токенов: в каждой строке название категории, число навыков, что она покрывает и сколько токенов занимают её навыки. Потом выбирается одна категория, и Claude читает её раздел, около 600 токенов. В примере автора запрос «resolve this merge conflict» приводит в раздел version-control.md, где лежат using-git-worktrees и нужный resolving-merge-conflicts. Остальные 13 разделов, около 10 тысяч токенов, остаются закрытыми. Найденный включённый навык вызывается как обычно, а у спящего Claude читает файл по указанному пути и выполняет его как инструкцию.

Обычно хватает одного раздела. Второй открывается, только если в найденной записи указана категория, которую Claude ещё не читал (на неё указывает сам каталог, модель тут не гадает), а третий не открывается никогда. Навыки специально разнесены по категориям с пересечениями, поэтому модели достаточно попасть в одну из подходящих категорий. Отключённые навыки в разделы не попадают вовсе, так что выключенный плагин не вернётся в работу обходным путём.

Вручную команду /skill-atlas:skill-search набирать почти не приходится: Claude вызывает её сам перед нетривиальной задачей, одной строкой называет выбранный навык и продолжает работу. Автор формулирует это так: поиск - «справка внутри задачи, а не результат».

Вместе с самим навыком поиска, около 400 токенов, одно обращение стоит примерно 2 400 токенов, и платить их приходится только тогда, когда поиск действительно случается. Автор признаёт, что выигрыш реален, «когда поиск нужен изредка», и бесплатным его не назовёшь, а приведённые цифры, подчёркивает он, измерены, а не прикинуты.

Категории модель составляет один раз. Первый запуск предлагает 8-12 категорий, названных по типу задачи пользователя, а не по продуктам, и после этого таксономия замораживается. Дальше новые навыки только раскладываются по готовым категориям. К каждому назначению привязан хеш описания, по которому его сделали, поэтому при изменении описания навык перепроверяется.

Установка

Плагин ставится из маркетплейса двумя командами: claude plugin marketplace add danielLublinsky/Skill_Atlas и claude plugin install skill-atlas@skill-atlas. Нужен только Python 3, без зависимостей и сетевых запросов, библиотека d3 лежит в самом репозитории. Один раз запускается /skill-atlas: он строит граф, раскладывает новые навыки по категориям и собирает atlas.html. Дальше всё свежим держит хук на SessionStart. Без плагина есть цели Makefile: make build, make render, make check для CI и make test, который гоняет тесты на фикстурах и не трогает настоящий ~/.claude. Лицензия Apache-2.0.

Что показывает граф

Навыки плагин ищет по манифестам: installed_plugins.json, затем plugin.json каждого плагина, затем настройки. Поэтому каталоги маркетплейсов и устаревшие кешированные версии не попадают в картину, а незарегистрированные копии видны как отдельные узлы. Наивный подсчёт, при котором навыком считается каждая папка с SKILL.md, на реальной машине завышает число навыков примерно на 60%; сравнить можно флагом build_graph.py --naive-count.

atlas.html самодостаточен и открывается прямо с диска без единого сетевого запроса. Уровень навыка показан заливкой узла, поэтому видно, почему навык не сработал; дубликаты имён перечислены внизу страницы, оба узла нарисованы. Любой навык или вложенный файл можно открыть во всплывающем окне и прочитать исходный markdown, не уходя из графа.

Навыки в графе - узлы, а рёбер два типа. Ссылка навыка на собственный вложенный файл помечается как битая, если файла нет на диске, и рисуется красным: опечатку в references/foo.md видно без открытия файлов. Упоминание одного навыка в другом помечается как висящее, если целевой навык отключён, не зарегистрирован или отсутствует. Ещё граф ловит навыки-сироты, а make check возвращает код 1 при любой битой ссылке или висящем упоминании, так что на нём можно остановить CI.

Упоминания плагин распознаёт строго: только имена в обратных кавычках, пути вида skills/<name> или однозначные имена через дефис, а блоки кода перед этим вырезаются. Нестрогое сопоставление, по словам автора, дало 91 ребро на коллекции из 41 навыка, и почти все они оказались обычными английскими словами.

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.