KotСкилл или ****CLAUDE.md****?
Скилл или CLAUDE.md?
Интересный вопрос, когда делать скилл, а когда достаточно CLAUDE.md?
CLAUDE.md — это факты о проекте. Всё, что ты рассказываешь новому разработчику в первый день: структура проекта, стек и версии, конвенции именования, архитектурные решения, внутренние библиотеки, как запустить, как прогнать тесты.
**Скилл **— это когда агент должен делать что-то конкретное, чего без инструкции не сделает или сделает неправильно. Если формулируется как “знай что…” — это CLAUDE.md. Если “когда попросят X, делай 1→2→3→4” — это скилл.
Пример. Описание внутреннего модуля — какие классы, какие абстракции, как подключать. Это CLAUDE.md. А “по описанию задачи сгенерируй код с использованием нашего модуля, создай нужные файлы, подключи зависимости” — это скилл.
Кстати, на больших проектах один CLAUDE.md в корне — не вариант. Раскидывайте по папкам ближе к коду. Агент подтянет контекст того модуля, в котором сейчас работает, а не будет пытаться переварить всё сразу.