Навык из нескольких файлов: когда одной инструкции мало — в Claude

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

Навык — это папка, а не файл

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

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

Что выносить в отдельные файлы

Хорошие кандидаты на вынос: образцы готовой работы («вот так выглядит наш правильный отчёт»), справочные таблицы и словари терминов, длинные чек-листы для редких веток, куски кода и команды, которые надо выполнить дословно. Плохие кандидаты — то, что нужно всегда: описание задачи, критерии готовности, порядок шагов. Если файл открывается при каждом запуске, ему место в главной инструкции.

Ссылайтесь на файлы по имени прямо в тексте инструкции и подписывайте, зачем каждый нужен: «форматирование берём из template.md», «расшифровка кодов регионов — в regions.md». Без такой подписи Claude либо откроет всё подряд, либо не откроет ничего.

Как это собрать

Самый быстрый путь — не писать структуру руками. Пройдите рабочую задачу в Claude Code так, как обычно, а в конце скажите: «Собери из того, что мы сейчас сделали, навык. Шаги оставь в главной инструкции, шаблон и справочник вынеси отдельными файлами и сошлись на них». Дальше правьте получившееся: убирайте лишние подробности из главного файла, переносите объёмное в соседние.

Совет

Проверяйте навык на задаче, где он должен ошибиться. Возьмите нетипичный случай и посмотрите, полез ли Claude в нужный справочный файл. Если нет — проблема почти всегда в описании навыка: там не написано, при каких признаках задачи открывать этот файл. Подробнее о самих навыках — в статье Skills в Claude Code.

Где купить Claude

Российская карта на сайте Anthropic не проходит. У нас в каталоге Claude Pro (2 090 ₽/мес), Max (от 11 010 ₽/мес) и пополнение API от $20: оплата картой РФ или СБП, поддержка на русском.