#вайбкодинг лайфхак №3

Каждую новую сессию с ИИ-агентом ты объясняешь одно и то же. Стиль кода, формат коммитов, команды для тестов, архитектура проекта. Агент блестящий, но у него амнезия. Каждое утро он забывает всё, что ты ему вчера рассказал.

Есть способ объяснить один раз и чтобы он помнил всегда. Называется "навык" (skill).

По сути это файл-инструкция, которую агент читает и применяет автоматически. Аналогия: ты нанял сотрудника и вместо ежеутренних объяснений дал ему регламент. Навык и есть такой регламент. Написал один раз, работает в каждой сессии.

Устроены они хитро. Навык загружается не целиком, а по уровням. Контекстное окно агента ограничено, и каждое лишнее слово вытесняет слова для решения задачи.

Уровень 1: название и описание. Агент видит их всегда. По ним решает, нужно ли активировать навык. Уровень 2: сама инструкция. Загружается только когда навык активирован. Уровень 3: скрипты, справочники, шаблоны. Подтягиваются точечно.

Как книга на полке: видишь обложку, открываешь если надо, листаешь приложения только по делу.

Главный секрет: большинство пишут в описании ЧТО навык делает. "Навык для постов в соцсетях." Агенту это бесполезно. Он не понимает, когда активировать.

Правильное описание отвечает на вопрос КОГДА: "Используй когда пользователь просит написать пост для Telegram, Threads, X или LinkedIn. Также активируй при запросах на контент-календарь или переупаковку постов."

Описание навыка пишется не для людей. Это инструкция агенту, когда включаться.

Четыре правила эффективных навыков:

1. Краткость. Контекстное окно — общий ресурс. Не пиши абзац там, где хватит строки. 2. Примеры вместо описаний. Один пример работает лучше трёх параграфов. 3. Свобода под задачу. Творческие задачи — общие указания. Критичные операции — пошаговые инструкции. Степень свободы зависит от цены ошибки. 4. Разгрузка. Детали выноси в отдельные файлы. Агент подтянет когда понадобится.

Куда класть? Папка .claude/skills/ внутри проекта. Минимум: одна папка с файлом SKILL.md. Нужны справочники или скрипты — кладёшь рядом в references/ и scripts/. В SKILL.md ссылаешься на них, агент подтянет по ходу дела.

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

Запуск: /имя-навыка или агент активирует сам по контексту.

Какой навык ты бы написал первым?

👍 — уже использую навыки 🔥 — надо попробовать