Свой скилл для Claude за один вечер

Карусель показала, что скилл — это папка с текстовым файлом. Здесь полный рецепт: что писать в файле, как проверить и что чинить, когда он не включается.

Из чего состоит скилл

Папка. Внутри файл SKILL.md. Рядом — скрипты, если нужны; чаще не нужны.

Файл делится на две части. Сверху — короткий блок с именем и описанием. Ниже — обычный текст: что делать, в каком порядке, чего не делать.

---
name: карусели
description: собирает карусель из референса;
  включается на «сделай карусель», «переделай виралку»
---

# Что делать
1. разобрать дизайн донора
2. переписать текст под нишу
3. отрисовать и показать мне

Это работающий скилл. Не заготовка — полноценный первый вариант.

Главная строка — описание

По нему система решает, звать скилл или нет. Всё остальное она прочитает потом, а описание читает всегда.

Так не работает:

помогает работать с текстами и повышает эффективность контента

Так работает:

пишет посты для телеграм-канала про вайбкодинг и Claude Code; включается на «напиши пост», «сделай прогрев», «контент-план», «дожим»

Разница в двух вещах. Первое: сказано, что именно делает — не «помогает», а «пишет посты». Второе: внутри стоят живые формулировки, которыми ты сам ставишь задачу. Система сопоставляет твою фразу с описанием; чем ближе слова, тем надёжнее срабатывание.

Практический приём: вспомни три последние формулировки, которыми ты просил это сделать, и вставь их в описание дословно.

С какого скилла начинать

Не с того, который кажется важным. С того, на который уходит больше всего часов.

Посчитай последнюю неделю честно. У меня это была отрисовка каруселей: полдня в редакторе на один пост, при том что тема и текст были готовы. Скилл под неё окупился в первый же день.

Правило: один скилл — одна работа. «Скилл для контента» не включится никогда, потому что такой задачи не существует. Существуют «собрать карусель», «написать пост», «разобрать день».

Что писать в правилах

Запреты работают лучше просьб. Просьба задаёт направление, запрет отсекает целый класс неподходящих ответов.

Мои рабочие:

Не пиши вступление. Начинай с факта.
Не выдумывай цифры. Нет данных — ставь пометку.
Не спрашивай разрешения на очевидный шаг.
Не подводи итог в конце — я дочитаю сам.

Плюс формат выдачи: что именно я должен увидеть, когда скилл закончил. Без этого получаешь пересказ процесса вместо результата.

Как проверить

Тремя задачами подряд, не чтением.

Включился сам? Если приходится звать по имени — описание слабое. Переписывай, добавляй свои формулировки.

Сделал по инструкции? Пропустил шаг — значит, шаг написан размыто. «Проверь качество» не выполняется; «открой три готовых файла и посмотри, не обрезан ли текст» выполняется.

Что ты правил руками? Вот это самое ценное. Твои правки — недостающие строки инструкции. Дописал их — на следующем прогоне править не придётся.

Честно про первые две недели

Первая версия будет так себе. Это нормально и это не повод её вылизывать заранее: скилл растёт из реальных поправок, а не из воображения.

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

Чего скилл не сделает: он не придумает за тебя, о чём говорить. Снимает производство, не решение.

Файл-заготовку, примеры рабочих описаний и полный список моих запретов я собрал в [МИКРО-ПРОДУКТ]: [ССЫЛКА-МИКРО].

Что чинить, когда скилл молчит

Симптом	Причина	Что делать
Не включается никогда	в описании нет твоих формулировок	вставить три живые фразы дословно
Включается не на те задачи	описание слишком широкое	дописать строку «когда НЕ включаться»
Включается, но делает по-своему	нет порядка шагов	пронумеровать действия в теле файла
Работает через раз	конфликт с соседним скиллом	развести описания, указать отличие явно
Выдумывает факты	нет запрета	добавить «нет данных — ставь пропуск»

Девять из десяти проблем сидят в первой строке таблицы. Прежде чем чинить логику, перечитай описание.

Проверка тремя задачами

1. Своя формулировка. Скажи так, как сказал бы коллеге: «сделай слайды по этой теме». Включился — триггер настроен.
2. Чужая формулировка. Попроси кого-то описать ту же задачу своими словами. Скилл, который ловит только твои привычные обороты, развалится через месяц.
3. Соседняя задача. Дай что-то похожее, но другое: «сделай обложку» вместо «сделай карусель». Хороший скилл не включится — и это правильное поведение, а не сбой.

Три проверки занимают пять минут и экономят неделю недоумения на тему «почему оно не работает».

Запреты работают лучше просьб

Просьба «пиши живо» не даёт модели никакого критерия — она и так считает, что пишет живо. Запрет даёт: он отсекает конкретное поведение.

Пять запретов, которые я держу почти в каждом скилле:

• Не выдумывать цифры. Нет данных — ставь пропуск, а не правдоподобное число.
• Не начинать с общих слов. Первое предложение — по делу, без разгона.
• Не делать списки одинаковой длины. Симметрия читается как машинная.
• Не ставить два призыва в конце. Два призыва — это ноль призывов.
• Не пересказывать то, что уже сказано выше. Повтор вместо развития — главный признак текста, написанного ради объёма.

Каждый запрет родился из конкретной поправки, которую я делал руками больше трёх раз. Это и есть правило: три ручные правки одного типа — новая строка в файле.

Частые вопросы

Сколько времени занимает написать свой скилл?

Первый рабочий вариант — вечер: папка, файл с описанием и порядком шагов, три проверки. Дальше он дописывается по мере того, как ты натыкаешься на грабли, и это уже минуты, а не часы.

Нужно ли уметь программировать, чтобы написать скилл?

Нет. Минимальный скилл — это текстовый файл с описанием и списком шагов. Скрипты добавляются позже и только там, где без них никак.

Почему скилл не включается сам?

Почти всегда потому, что в описании нет тех слов, которыми ты ставишь задачу. Вспомни три последние формулировки и вставь их в описание дословно.

Сколько скиллов заводить на старте?

Один — под задачу, которая отнимает больше всего часов в неделю. Второй появится сам, когда заметишь, что объясняешь одно и то же второй раз.

Дальше по теме

• 289 скиллов установлено, работают 12. Как я отбирал — почему своих скиллов должно быть мало.
• Три файла, которые делают из Claude сотрудника — общие правила, которые действуют для всех скиллов сразу.
• 6 скиллов превращают Claude из универсала в команду — с какого набора я начинал.