Почему из сотни скиллов в Claude Code у меня работает около десяти и как делать так, чтобы агент их использовал

Навыки, они же skills Claude Code, сейчас ставят пачками: каталоги растут, и кажется, что чем больше инструкций у агента, тем он сильнее. У меня в Claude Code больше сотни навыков, а в работе около десятка. Остальные почти не срабатывают. Агент выбирает навык по короткому описанию, и если из описания непонятно, когда навык нужен, навык молчит.

Навык (skill) в Claude Code — готовая инструкция для агента на одну задачу: как искать, в каком порядке действовать, что проверить в конце. Сам Claude Code — программа Anthropic с ИИ-агентом внутри. Агент по вашей просьбе сам выполняет работу на компьютере. Без навыка задачу в каждой новой сессии приходится объяснять заново. С навыком агент берёт инструкцию сам.

Как сделать свой навык для работы с текстами, я уже рассказывал. Здесь другой вопрос: сколько навыков ставить и почему поставленный навык может так и не сработать.

Ставить стоит столько навыков, сколько у вас задач, которые повторяются каждую неделю. А выбор огромный: Cult of Claude на 30 октября 2026 года индексирует 39 697 навыков из 28 975 публичных репозиториев. Когда выбор такой, брать про запас очень хочется.

Я так и сделал: остальные навыки поставил на всякий случай, вдруг пригодятся. Сейчас их больше сотни, а работает около десятка, то есть примерно каждый десятый. Остальные почти не срабатывают, и от запаса остался только длинный список.

У меня прижились навыки под задачи, которые повторяются:

• Поиск и чтение страниц. Веб-поиск, извлечение текста страницы и обход защиты от роботов: на части сайтов стоит проверка, которая не пускает программы к тексту, и этот навык помогает агенту всё-таки прочитать страницу.

• Заголовки. Навык подбора заголовков собран на моих правках: то, что я раньше исправлял в заголовках, агент учитывает в новых вариантах.

• Частоты запросов. Навык снимает частоты из Вордстата. Это сервис Яндекса, где видно, сколько раз в месяц ищут запрос.

• Черновик на площадке. Навык через браузер переносит готовую статью в черновик площадки.

• Презентации и журнал сессии. Один навык собирает HTML-презентации, то есть слайды в виде веб-страницы, которая открывается в браузере. Другой ведёт журнал того, что агент сделал за сессию.

• Метрика и Вебмастер. Навыки достают данные Яндекс Метрики, счётчика посещений сайта, и Яндекс Вебмастера, кабинета, где видно, как поиск Яндекса видит сайт.

Ничего экзотического: поиск, Яндекс, черновики и слайды. Обычная рутина, которая возвращается каждую неделю.

Агент выбирает навык по описанию, и если из описания не ясно, когда навык нужен, он не сработает. По документации Anthropic, при старте в контекст загружаются только имя и описание каждого навыка, а полный текст инструкции Claude читает, когда навык подходит к задаче. Контекст — это весь текст, который ИИ-модель держит в голове за раз. Похоже на меню в ресторане: названия и короткие подписи видны сразу, а рецепт открывают только у выбранного блюда.

Там же Anthropic пишет, что имя и описание определяют, сработает ли навык на текущую задачу. Выбирать агенту иногда приходится из сотни навыков и больше, поэтому в описании нужны две вещи: что навык делает и когда его применять. У меня это видно на практике: навык с расплывчатым описанием не вызывается никогда.

В Codex, агенте от OpenAI, всё устроено так же. OpenAI пишет, что Codex сначала видит имя и описание навыка, а когда навыков много, первым делом сокращает описания.

Бывает, что навык работает, если позвать его командой по имени, но сам агент его не берёт. Тогда причина обычно в описании или в отключённом автовызове: это настройка, которая запрещает агенту звать навык без команды. Сначала проверьте в настройках самого навыка, не запрещён ли автовызов, и только потом правьте описание. Если ввести в чате с агентом команду /skills, Claude Code покажет найденные навыки, а команда /context покажет, сколько места в контексте занимают их описания.

Список описаний навыков занимает место в контексте, и бюджет у него по умолчанию всего 1% контекста. Если описания не влезают, первыми сокращают описания тех навыков, которые зовут реже всего. В обсуждении на GitHub это назвали ожидаемым поведением: бюджет можно поднять в настройках или укоротить сами описания.

В том же обсуждении пользователь с большим набором показал, что у 81 навыка описания отброшены и остались одни имена. Круг получается неприятный: навык зовут редко, поэтому его описание сокращают первым, а без описания агенту ещё труднее понять, что навык нужен.

Описание лежит в самом файле навыка у вас на компьютере (это не текст со страницы каталога), и в нём нужны две части: что навык делает и в какой ситуации его звать, теми словами, которыми вы ставите задачу. Вторая часть называется триггером: это повод, по которому агент понимает, что пора взять навык. Допустим, в описании написано *помогает работать с данными сайта*. Когда это нужно, агент не поймёт. А вот так: *достаёт из Яндекс Метрики посещения сайта, нужен, когда просят цифры по трафику*. Здесь есть и действие, и повод.

Темы для навыков Anthropic советует искать в повторах: выполнить задачу без навыка и заметить, какой контекст приходится давать агенту снова и снова. Мои рабочие навыки закрывают как раз такие повторы: частоты запросов, перенос статьи в черновик, данные из кабинетов Яндекса.

Сотня навыков на всякий случай — это мёртвый груз: агент зовёт навык по описанию, и расплывчатое описание означает, что навык не сработает никогда. Ставить стоит только навыки под задачи, которые повторяются каждую неделю, и у каждого должно быть описание, из которого ясно, когда его вызывать.

Ценность не в количестве навыков, а в навыках под повторяющиеся задачи с чётким триггером. Мой рабочий десяток весь состоит из такой еженедельной рутины. Остальные девяносто с лишним навыков так и стоят и почти не срабатывают.