Сравниваем skills, инструменты и CLAUDE.md
В ноябре 2024 Anthropic ввела чёткое разделение: skills, инструменты (tools) и глобальный CLAUDE.md выполняют разные роли в архитектуре агента. Skills отвечают за специализированные сценарии — например, автоматизация ревью или генерацию отчётов. Инструменты дают доступ к внешним сервисам или API (например, парсер PDF, переводчик, HTTP-запросы).
CLAUDE.md — это единая подсказка для всего агента, где задаются глобальные правила, стиль общения и ограничения. Этот файл не содержит пошаговых инструкций и не активируется по сценарию — он всегда влияет на модель. Skills, напротив, подключаются динамически: агент выбирает нужный навык, если задача совпадает с областью его применения.
В коде разница заметна по структуре: skills — это директории с SKILL.md, инструменты регистрируются через API или SDK как отдельные endpoints, а CLAUDE.md располагается в корне конфигурации агента. Ошибка в выборе между этими сущностями приводит к неэффективной работе агента.
💡 Аналогия
Skills — как пошаговые рецепты, инструменты — как кухонная техника, а CLAUDE.md — как правила поведения на кухне. Для идеального блюда нужны все три составляющих.
Ключевые моменты
Skills содержат сценарии и инструкции, активируемые по требованию.
Инструменты расширяют возможности агента, предоставляя доступ к API или данным.
CLAUDE.md определяет поведение модели в целом, без процедурной логики.
Структура файлов и подключение навыков, инструментов и подсказок различаются на уровне кода.
Следующий урок
Настраиваем создание и загрузку навыка через CLI
Практика