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

(и это не только про кодинг!)

Ты уже пользуешься чужими навыками в Claude Code. А свои писать не умеешь (зуб даю!).

Я сам совершал эти ошибки: писал навык с помощью агента, не вычитывал, мешал в одном навыке кучу всего. Они оседали балластом и срабатывали невпопад.

Здесь — двадцать правил, на основе официальной документации Anthropic. Половину твоих навыков они забракуют, и это нормально.

Имя и описание

1. Навык должен быть коротким. Не объясняй то, что модель уже знает. Каждое лишнее слово съедает контекст.

2. В описании пиши КОГДА использовать, не только ЧТО. Без триггеров навык не запустится в нужный момент. Это поле description в шапке SKILL.md.

3. Имя — глагол плюс объект: writing-proposals, qualifying-leads. Никаких общих названий типа helper, utils, documents.

4. Один навык — одна работа. Не делай навык "маркетинг" на всё. Лучше отдельно: контент-план, написание постов, разбор обратной связи.

Структура

5. Главное сразу, детали — в приложениях. SKILL.md делай коротким оглавлением со ссылками. Подробности — в отдельных файлах рядом (папка resources).

6. Не делай матрёшку из ссылок. SKILL.md → advanced.md → details.md — Claude может не дочитать. Все важные файлы — на один уровень глубины.

7. Процесс — по шагам. "Подготовь хорошее КП" не работает. Лучше: 1) задача клиента, 2) список работ, 3) этапы, 4) допущения, 5) обоснование цены.

Свобода и качество 8. Степень свободы — под риск задачи. Для поста — гибкие правила. Для рассылки 5000 клиентам — точные шаги без отклонений.

9. Валидационный цикл. Сгенерировал → проверил по чеклисту → исправил → проверил снова. С первого раза модель пишет хорошо в 60% случаев. С циклом — почти всегда.

10. Шаблон результата. Если на выходе должно быть КП, отчёт, письмо или таблица — добавь готовый шаблон отдельным файлом. Без шаблона результат разный каждый раз.

11. Конкретные примеры, не пожелания. Не "сделай красиво", а пара "запрос → идеальный ответ". Модель копирует то, что видит.

Чистота

12. Не пихай устаревающую инфу в основное тело. "До июня старый тариф, после — новый" через год превратится в тыкву. История — в отдельный блок.

13. Одна терминология. Не смешивай "клиент", "заказчик", "лид". Используй везде один термин.

Скрипты

14. Повторяющееся — в скрипт. Если действие всегда одинаковое, пусть его делает программа, а не модель каждый раз заново.

15. Скрипт сам разбирается с ошибками. Пусть напишет "файл не найден" или "клиент уже в базе", а не кидает сырое исключение в модель.

16. Зависимости — открыто. Если навык требует программы или сервиса — напиши прямо в начале. Чтобы при первом запуске сразу было понятно, чего не хватает для полноценной работы.

17. Пути — через прямой слэш. папка/файл работает везде. папкафайл ломается на всём, кроме Windows.

Развитие

18. Проверяй на реальных сценариях, не на идеальном. Минимум три кейса: обычный запрос, запрос с неполными данными, нестандартный запрос с конфликтом правил.

19. Навык делается итеративно. Сначала реши задачу руками раз, два. Заметь, что повторяется. Только потом упакуй. Преждевременный навык = мёртвый навык.

20. Один путь по умолчанию плюс одно исключение. "Изучай клиента через JTBD, CustDev, Design Thinking, Lean Startup или Value Proposition Canvas" — модель будет колебаться. Лучше: "Используй JTBD-интервью. Если продукта ещё нет на рынке — CustDev по Стиву Бланку".

Чеклист перед использованием: — имя конкретное — описание с триггерами "когда применять" — SKILL.md без воды — детали в отдельных файлах, на один уровень — процесс по шагам — шаблон результата — конкретные примеры — цикл "сделал → проверил → починил" — повторяющееся в скрипте — проверка на 3+ сценариях

👍 — уже пишу свои навыки 🔥 — пора садиться и писать