🧠 Архитектура скиллов Claude: от простого к сложному

Архитектура скиллов в Claude: от простого к сложному

Ключевые тезисы:

Разница между скиллами — не в коде, а в архитектуре
Монофайл (всё в одном) работает, но неудобен для правок и модернизации
Модульная система (отдельные файлы для логики, ресурсов, правил) — профессиональный подход
Цель — превратить скилл из одного файла в удобный, легко модернизируемый инструмент
Используется принцип Progressive Disclosure (постепенное раскрытие) — скилл достаёт информацию из файлов по мере необходимости

Базовый скилл (нулевой уровень)

Простая папка с одной инструкцией (.skill файлом). В нём прописывается:

Что делает скилл
Когда запускается
Пошаговый план действий
В конце — просьба упаковать скилл для установки одним кликом

Пример: Скилл для поиска новостей и формирования дайджеста.

Проблема: Всё в одном файле. Любая правка — риск что-то сломать. Неудобно редактировать (например, список источников).

Апгрейд 1: Вынос ресурсов

Ресурсы — списки, данные, конфигурации, источники.

Принцип: Выносим ресурсы в отдельный файл (по умолчанию — JSON).

Изменение одного компонента не затрагивает остальные
В главную инструкцию добавляем ключевую фразу: «Перед сбором новостей сначала прочитай файл с источниками» (Progressive Disclosure)

Апгрейд 2: Вынос логики в скрипт

Рабочую логику (например, обход сайтов и сбор информации) выносим в отдельный исполняемый файл (например, Python-скрипт).

Преимущества:

Действия выполняются всегда одинаково и предсказуемо
Экономия токенов (Claude запускает скрипт, а не выполняет действия «вручную»)

Метод создания скрипта для неспециалистов: Метапромтинг

Просим Claude: «Помоги мне написать промпт для генерации исполняемого файла внутри моего скилла».
Клод выдаёт технически правильный промпт с кодом.
Копируем ответ в новый чат и генерируем скрипт.

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

Апгрейд 3: Вынос правил в отдельные файлы

Главная инструкция не должна быть «энциклопедией». Она должна стать «картой».

Создаём отдельную папку для правил и выносим туда:

Правила фильтрации
Шаблоны оформления (темплейты)
Правила перевода, обработки ошибок и т.д.

Критически важная фраза: Нужно явно прописать, чтобы Claude не дублировал правила в главной инструкции. Они должны жить только в своих файлах.

Апгрейд 4: Связи с внешним миром

Скилл научится взаимодействовать с внешними сервисами и другими скиллами.

Пример реализации:

Запись в Notion: После формирования дайджеста скилл создаёт страницу в указанной базе Notion через коннектор.
Интеграция с другим скиллом: Спрашивает пользователя, нужно ли сделать пост в Telegram. Если «да», — вызывает второй, уже существующий скилл, который умеет писать посты в определённом стиле.

Выводы:

Готовый шаблон промпта позволяет собрать скилл с нужной архитектурой за один раз
Не все апгрейды обязательны для каждой задачи (ненужные можно удалить из шаблона)
Архитектура на основе отдельных файлов делает скилл устойчивым к изменениям, удобным для чтения и лёгким в модернизации