Многие пользователи искусственного интеллекта постепенно накапливают коллекцию многоразовых промптов. Это может быть страница в Notion, специальный инструмент для хранения запросов или просто текстовые заметки на рабочем столе, которые никогда не закрываются. Приемы различаются, но привычка остается прежней. Автор материала долгое время не сомневался в эффективности такого подхода, пока не перенес те же самые промпты в файлы навыков Claude. После этого ручной выбор нужных инструкций стал очевидным, и возвращаться к прежнему методу уже не захотелось.
Устройство привычных хранилищ промптов
Официально библиотека промптов представляет собой коллекцию многоразовых запросов, к которым можно получить доступ, чтобы не вводить их заново. На практике регулярное использование ИИ подразумевает наличие подобного архива. Это может быть специализированный инструмент вроде PromptLayer, заметки в блокноте или просто заученные фразы.
У автора основным хранилищем служили стикеры на рабочем столе. Промпты корректировались, но в них сохранялись универсальные рабочие схемы — например, создание низкоуровневого каркаса интерфейса со строгими правилами серой шкалы или проверка компонентов по конкретному чек-листу. Процесс сводился к поиску нужной заметки, переключению с помощью комбинации клавиш, вставке текста и его адаптации под текущую задачу. Такой подход максимально прост и работает нормально.
Однако при регулярном редактировании промптов прямо во время сессии легко забыть обновить сохраненную версию. В результате в следующий раз вставленный запрос может оказаться неприменимым, так как рабочий процесс изменился. Со временем забывается и то, что именно было сохранено, из-за чего приходится заново решать уже решенные задачи. Кроме того, пользователю приходится самостоятельно выполнять маршрутизацию: сканировать собственный стек, выбирать подходящий вариант и обрабатывать его вручную.
Принцип работы навыков в Claude Code
Навыки отличаются тем, что это не просто сохраненные промпты, а инструкции, которые помощник считывает самостоятельно. Именно в этом кроется главное улучшение. Навык в Claude Code представляет собой папку. Для персональных задач она располагается по пути ~/.claude/skills/skill-name/, а для командной работы — внутри директории .claude/skills/ в самом проекте. Внутри находится файл SKILL.md, содержащий метаданные YAML с названием и описанием, а также основные инструкции в теле файла.
Главную работу выполняет функция автоматического вызова. При запуске Claude Code загружает исключительно название и описание каждого доступного навыка, что составляет около 100 токенов на каждый элемент. При отправке сообщения система проверяет, соответствует ли описание какого-либо навыка выполняемому действию, и если совпадение найдено, загружает полный текст навыка в контекст. Навык также можно вызвать напрямую с помощью команды вроде /wireframe или по названию папки, однако автоматический путь представляет наибольший интерес.
Сопоставление происходит на семантическом, а не ключевом уровне: Claude читает сообщение и самостоятельно оценивает, что именно подходит под задачу. Существует и третий уровень, известный как прогрессивное раскрытие. Если для навыка требуется более нескольких сотен строк, дополнительный материал можно разделить на вспомогательные файлы внутри той же папки и сослаться на них из SKILL.md. В таком случае Claude загружает эти файлы только тогда, когда активируется соответствующая ветка.
В результате нагрузка по маршрутизации перекладывается с пользователя на систему. Достаточно описать желаемый результат, а Claude сам выберет подходящий вариант. Кроме того, в папке хранится только одна каноническая версия каждого навыка, поэтому устаревание данных происходит реже.
Большие навыки с ветвлением против компактных инструкций
Начало работы с навыками ставит перед выбором: создать один крупный навык с внутренним ветвлением или множество небольших и узкоспециализированных. Автор использовал комбинацию обоих подходов, так как сам паттерн важнее конкретных деталей. Главное — это защищает от необходимости переписывать инструкции спустя пару месяцев, избавляя от зависимости от устаревшего архива.
Шаблон крупного навыка подразумевает одну папку с единственным файлом SKILL.md, внутри которого прописаны ветвления в стиле «если пользователь просит каркас, сделай это, если просит критику — сделай то». Такой подход удобен, когда задачи разделяют общий контекст. Например, работа с интерфейсами опирается на единые правила: палитру серой шкалы, реальные метки вместо текста-заполнителя и крестики для заполнителей изображений. В результате один навык охватывает создание каркасов, критику и прототипирование макетов без дублирования общих частей.
Шаблон компактных навыков состоит из множества папок, каждая из которых выполняет одну задачу и имеет точное описание. Это лучше подходит для несвязанных задач, поскольку Claude легче правильно выполнить маршрутизацию из-за меньшего количества пересечений. Ошибкой крупного навыка является то, что длинный файл расходует токены на неиспользуемые в текущей сессии ветки. Прогрессивное раскрытие решает эту проблему путем переноса тяжелых деталей в справочные файлы. Компактные навыки тоже могут давать сбои, но по другой причине — из-за пересечения описаний. Поэтому точность формулировок критически важна.
Поле описания выполняет роль полноценного слоя маршрутизации, хотя многие описывают его как документацию. Описание должно читаться как естественная фраза. Если в живой речи человек говорит «нарисуй каркас страницы входа», то в описании обязательно должно присутствовать слово «каркас», а не формулировка вроде «генерация низкоуровневых структурных HTML-чертежей для планирования интерфейсов».
Итоги перехода на систему навыков
Использование навыков не изменило представлений о том, что именно должен делать Claude Code, так как прежние промпты работали хорошо. Изменилось лишь то, кто выполняет маршрутизацию. Теперь отпала необходимость прокручивать списки, копировать и вставлять текст вручную, что позволило оптимизировать повседневные рабочие процессы.
