temavorobeyНавык в Claude Code — это папка с файлом инструкций, который агент подхватывает, когда задача подходит. Пока всё работает, это самый приятный способ автоматизации: один раз описали процесс, дальше он повторяется одинаково. А потом навык вдруг перестаёт вызываться, или срабатывает там, где не надо, или делает половину и останавливается.
Сначала проверьте, что Claude вообще видит файл
Самая частая причина — навык лежит не там или называется не так. Навык живёт в папке проекта, в каталоге .claude/skills/, отдельной подпапкой, внутри которой файл SKILL.md. У файла есть шапка с полями name и description; если шапка съехала по синтаксису (лишний отступ, незакрытая кавычка, потерянные разделители), файл не разберётся целиком — и навыка для агента просто не существует.
Проверка занимает минуту: начните вводить в сессии слэш и посмотрите, появляется ли навык в подсказке по имени из поля name. Не появился — вопрос к расположению файла и его шапке, а не к формулировкам внутри. И помните: свежесозданный навык может не подхватиться в уже открытой сессии, перезапустите её.
Навык виден, но не вызывается сам
Если по прямой команде навык отрабатывает, а сам по себе никогда не включается, дело почти всегда в описании. Claude решает, применять ли навык, по полю description — он сопоставляет его с тем, что вы просите. Расплывчатое «помогает с документами» не совпадёт ни с чем конкретным.
Пишите описание как условие срабатывания, а не как рекламу: что делает навык и когда его брать. «Готовит релизные заметки: собирает изменения из git-истории с прошлого тега и раскладывает по разделам. Использовать, когда просят changelog или список изменений к версии». Заодно проверьте, нет ли рядом второго навыка с похожим описанием — при пересечении агент будет выбирать то один, то другой, и выглядит это как случайность.
Навык запускается, но не доводит дело до конца
Здесь смотрите на две вещи. Права: если навык читает файлы, пишет их или запускает команды, а разрешения нет, он упрётся в запрос подтверждения или остановится. И сами инструкции: длинный навык с ветвлениями на все случаи жизни выполняется хуже короткого и линейного. Делает три разные работы — разнесите на три.
Отлаживать удобнее всего разговором. Попросите прямо: «Прочитай навык release-notes и своими словами скажи, когда его нужно применять и что он делает по шагам». Если пересказ не совпадает с задумкой — правьте не запрос, а сам файл навыка. Про то, как навыки устроены и пишутся с нуля, у нас есть отдельная статья про Skills в Claude Code.
Совет
Проверяйте навык на задаче, ответ на которую знаете заранее: сразу видно, что он взял не тот источник или пропустил шаг. И правьте по одной вещи за раз, иначе через три правки будет непонятно, какая из них помогла.
Где купить Claude
Claude Code работает на платных тарифах, а российской картой на сайте Anthropic оплата не проходит. У нас есть Claude Pro (2 090 ₽/мес), Max 5x (11 010 ₽/мес), Max 20x (22 010 ₽/мес) и пополнение API от $20 — картой РФ или через СБП, с поддержкой на русском.
Обсуждение
0 комментариев