Claude читает только первые 100 строк файла в навыке. Семь новых правил сборки навыков

В ролике я пообещал все семь правил и запрос для проверки своих навыков. Сначала о том, откуда новость.

Что изменилось

1 октября Саймон Скрейпс выпустил разбор «Всё, что вы знали о навыках, устарело». За день 103 тысячи просмотров. Он прошёл по обновлённой странице рекомендаций Anthropic по сборке навыков и вытащил семь правил, которые касаются уже написанных навыков.

Главная находка. Когда Claude открывает длинный справочный файл внутри навыка, он не всегда читает его целиком. Сначала он просматривает первые 100 строк и по ним решает, пригодится ли файл. Если важные правила лежат после сотой строки, а в начале нет подсказки, что они там есть, шанс, что Claude до них дойдёт, низкий.

Отсюда и симптом, знакомый многим: навык работает через раз и как будто игнорирует часть инструкций.

Правило 1. Оглавление в длинных файлах

В начало каждого справочного файла длиннее 100 строк ставь список его разделов. Пять-семь строк: что внутри и в каком порядке. Тогда Claude видит карту файла и либо читает его целиком, либо идёт прямо в нужный раздел.

Правило 2. Три степени свободы

Раньше все шаги навыка писали одинаково подробно. Anthropic предлагает иначе: подробность зависит от того, насколько шаг хрупкий.

Свобода	Как писать	Пример
Высокая	цель обычными словами	разобрать созвон, написать пост
Средняя	шаблон с настройками	еженедельный отчёт клиенту
Низкая	готовый скрипт, без вариантов	счёт, удаление, всё про деньги

Три вывода Саймона. В одном навыке уровни можно смешивать: текст письма свободный, выставление счёта жёсткое. Вопрос к каждому шагу один: что случится, если Claude сделает по-своему. И низкая свобода почти всегда означает скрипт, а не более строгие слова.

Правило 3. Проверяй на той модели, на которой работаешь

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

У Anthropic по одному вопросу на модель. Для младшей: хватает ли указаний. Для средней: понятно и экономно ли написано. Для старшей: нет ли лишних объяснений.

Практический совет: прогони самый нужный навык на одной задаче на трёх моделях. Младшая пропустила шаг: сделай его яснее или преврати в скрипт. Старшая с навыком работает хуже, чем без него: вычёркивай инструкции.

Правило 4. Ссылки в один уровень

Главный файл навыка советуют держать до 500 строк и относиться к нему как к оглавлению всего остального. Подробности выносятся в отдельные файлы.

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

Если навык покрывает несколько областей, дели файлы по областям. Вопрос про выручку не должен подгружать файл про маркетинг.

Правило 5. Чек-лист для длинных процессов

Для сложной работы дай Claude список шагов, который он копирует в ответ и отмечает по ходу. Это не противоречит совету «давай цель, а не шаги»: чек-лист нужен там, где важен порядок. Сначала проверить данные, потом строить по ним отчёт.

Пример Anthropic без кода: исследование по документам. Пять строк, и ключевая из них последняя: проверь ссылки на источники, если не сходится, вернись к шагу три. Эта строка не даёт поставить галочку на проваленном шаге.

Правило 6. Петля самопроверки

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

Отсюда же самообучение навыка. Если черновик провалился по причине, которой нет в правилах, попроси Claude предложить новое правило в конце работы. Одобрил: оно уходит в документ.

Правило 7. Не считай, что всё установлено

Навык работает у тебя, потому что нужные программы ты поставил полгода назад и забыл. На чужом компьютере он сломается в первый день. Рядом с каждым скриптом пиши строку установки того, что ему нужно. Если уже стоит, Claude этот шаг пропустит.

Запрос для проверки своих навыков

Пройди по всем навыкам в моей папке навыков. Для каждого проверь: 1) есть ли справочные файлы длиннее 100 строк без оглавления в начале; 2) есть ли файлы, до которых можно дойти только через другой файл, а не из главного; 3) главный файл длиннее 500 строк или нет; 4) есть ли шаги, связанные с деньгами, удалением или отправкой, которые описаны словами, а не скриптом; 5) указано ли, что нужно установить. Покажи таблицей. Ничего не исправляй, пока я не одобрю.

Последняя фраза нужна: сначала список проблем, потом правки.

Что я делаю у себя

У меня десятки навыков, и после этого разбора первым делом я проверяю их на цепочки ссылок и на длинные файлы без оглавления. Второе, что забрал: всё, где ошибка необратима, у меня и так вынесено в скрипты. Проверка описаний рилсов, например, это скрипт с кодом возврата, а не просьба «проверь длину».

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

Как написать первый навык с нуля, есть в статье свой навык для Claude. Про ворота, через которые работа не проходит без проверки: четыре ворот Shopify.

Частые вопросы

Это касается обычного чата Claude?

Навыки работают и в чате, и в Claude Code. Правила одни.

Нужно ли переписывать все навыки?

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

Сколько строк должно быть в оглавлении?

По числу разделов файла. Обычно пять-семь строк.

Продолжение в Telegram

Как я собираю и чиню свои навыки, показываю каждый день в Telegram-канале: рилсы, статьи, воронки и все грабли по ходу. Подписывайся, там продолжение этой темы: t.me/Evgeniy_Tolstobrov