AI-скиллы: как научить нейросеть работать по-твоему и перестать объяснять одно и то же

Признаюсь честно. Целый год я вёл себя как идиот.

Каждое утро я открывал нейросеть и печатал одно и то же. «Пиши в таком стиле. Проверяй обработку ошибок. Вот структура проекта. Не суй пароли прямо в код». Каждое. Утро.

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

Я жаловался коллегам: «умная железка, а памяти — ноль». Коллеги сочувственно кивали. Мы все так жили. Объясняли AI по кругу одно и то же и считали, что так и надо.

А потом один знакомый посмотрел на меня — и рассказал анекдот.

Анекдот про Хаима, который всё объясняет

Наводнение. Вода прибывает. Набожный Хаим забрался на крышу и молится: «Господи, спаси».

Проплывает лодка. «Хаим, прыгай!» — «Нет, Бог меня спасёт».

Прилетает вертолёт, скидывают лестницу. «Хаим, хватайся!» — «Нет, Бог меня спасёт».

Хаим утонул. На том свете возмущается: «Господи, я же всю жизнь молился! Почему Ты меня не спас?»

А Бог отвечает: «Я тебе лодку посылал. И вертолёт. Ты чего сидел-то?»

Так вот. В этой истории про AI я был Хаимом.

А лодка, которую мне месяцами совали под нос — называется скилл. Я просто не знал, что это и зачем оно мне.

Сейчас расскажу. Потому что этот «вертолёт» реально вытаскивает из болота ежедневного «объясняю по сотому разу». И собирается он за десять минут.

Что такое скилл (и почему я так долго тупил)

Если по-взрослому: скилл (AI skill) — это набор инструкций для AI, записанный в отдельный файл SKILL.md. Один раз написал — и нейросеть достаёт его сама, когда попадается подходящая задача. Не по твоей команде, а по описанию скилла.

И, кстати, почему «скилл»? Да потому что это буквально навык — в том же смысле, что у тебя. Ты научился водить машину — и больше не вспоминаешь каждый раз, где педали и как трогаться. Навык вшит, включается сам. Скилл делает ровно это с AI: ты один раз объясняешь ему что-то — и оно становится его навыком, который он достаёт на автомате. Не шпаргалка, которую надо каждый раз зачитывать вслух, а умение, которое просто есть.

Вот это «сама» я и проморгал. Мне казалось, что AI надо каждый раз водить за ручку. А оказалось — можно один раз объяснить, и всё.

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

Промпт — это когда ты просишь один раз. «Напиши функцию сортировки». Получил, забыл. Завтра просишь заново.

Спецификация — это подробное ТЗ на один проект. Работает отлично, но ровно один раз.

Скилл — это должностная инструкция. Она лежит на полке. Прилетела подходящая задача — AI сам снимает её с полки и работает по ней. Ты молчишь. Он уже всё знает.

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

Если совсем коротко: скилл — это способ один раз научить AI работать так, как надо тебе, и больше к этому не возвращаться.

Год. Год я мог не возвращаться. Но я был Хаимом.

«А чем это отличается от системного промпта?»

Отвечаю, потому что сам первым делом это спросил.

Системный промпт лупит по всему подряд. Написал «отвечай в стиле пирата» — и теперь AI пират даже когда ты просишь посчитать налоги. Аррр, приятель, твоя ставка НДС — двадцать процентов.

Скилл срабатывает только когда он к месту. У меня их теперь штук пятнадцать: один ревьюит код, другой пишет коммиты, третий разгребает логи. И AI сам выбирает нужный под задачу. Остальные в этот момент молчат в тряпочку.

Системный промпт — это правило для всех. Скилл — это спец, которого зовут по делу.

Как AI понимает, что пора

Тут я ждал какой-то магии. Магии не было. Всё до обидного просто.

У каждого скилла есть описание — одна строчка про то, что он делает и когда его применять. AI держит все описания перед глазами. Прилетела задача — пробежался по описаниям, нашёл подходящее, достал скилл. Всё.

Называется это автотриггеринг: AI сам сопоставляет описание каждого скилла с твоей задачей и решает, доставать его или нет. Ты не зовёшь скилл руками, не кричишь «эй, примени инструкцию номер три». Ты просто ставишь задачу. А скилл появляется сам — как нормальный официант, который не висит над душой весь вечер, но материализуется ровно тогда, когда тебе что-то понадобилось.

Запомни слово «описание». Через минуту выяснится, что вся конструкция держится на нём. И что именно на нём все спотыкаются.

Собираем мой первый скилл. За 10 минут. Прямо сейчас

Хватит теории. Давай соберём настоящий. Тот самый, с которого начал я — ревьюер, который проверяет код перед тем, как ты зальёшь его в прод.

Знаешь же за AI эту привычку — уверенно оставлять в коде дыры? Незахешированные пароли, SQL-инъекции, забытая обработка ошибок. Вот скилл, который ловит это за тебя. Каждый раз. Без напоминаний.

Шаг 1. Папка и файл

Создаёшь папку — code-review. Внутри файл — SKILL.md. Обычный текстовый файл, никакого программирования, выдыхай.

Устроен он из двух частей: шапка с полями name и description (это метаданные) и тело с самой инструкцией. Всё, других обязательных частей нет.

Шаг 2. Пишешь шапку

Первым делом — метаданные. Три дефиса, два поля, три дефиса:

---
name: code-review
description: Проверяет код на безопасность, обработку ошибок и соответствие стилю проекта. Применять при ревью кода перед коммитом или мержем.
---

Видишь description? Он написан не «проверка кода», а конкретно: что делает и когда включать. Запомни, я не просто так это выделил.

Шаг 3. Пишешь тело

Ниже шапки — обычным человеческим текстом объясняешь, что делать:

# Ревью кода

Ты — придирчивый ревьюер. Найди проблемы до того,
как они попадут в прод.

## Что проверять
- Пароли и секреты не захардкожены в коде
- SQL-запросы параметризованы, инъекций нет
- Ошибки обработаны: что если данных нет,
  они пустые или в кривом формате
- Все импорты и методы реально существуют
- Код соответствует стилю проекта

## Формат ответа
Список проблем по убыванию критичности. Для каждой:
файл, строка, что не так, как починить.
Если всё чисто — так и скажи, не выдумывай проблем.

Всё. Скилл готов. Я не шучу.

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

Теперь когда я говорю «глянь код перед коммитом» — AI сам видит, что под это есть code-review, достаёт его и идёт ровно по моему чек-листу. Не «ну вроде норм», а по моим правилам. Одинаково внимательно. Даже в пятницу в 19:00.

Шаг 4 (если разойдёшься)

Рядом с SKILL.md можно положить папки scripts/ (готовые скрипты, которые AI запускает сам) и references/ (примеры, длинные списки правил, документация). Для первого скилла — не нужно. Но знай: потолка нет. Скилл масштабируется от трёх строчек до мини-программы.

А теперь то, на чём я обжёгся

Помнишь, я просил запомнить слово «описание»?

Мой первый скилл не работал. Вообще. Я его написал, красивый, а AI его в упор не видел.

Знаешь почему? Я написал в описании «работа с кодом». Гениально. Ёмко. Бесполезно. AI просто не понимал, когда эту штуку доставать, и она пылилась на полке.

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

Это та же болезнь, что и с промптами. Размытый промпт — размытый код. Размытое описание — мёртвый скилл. AI не телепат, он работает с тем, что ты написал, а не с тем, что ты имел в виду.

Правило, которое я вынес кровью: в описании всегда отвечай на два вопроса — что скилл делает и когда его применять. Забьёшь на второе — и самый умный скилл будет молча тонуть, как Хаим.

Не изобретай велосипед

Ещё одна вещь, которую я понял поздно: писать всё с нуля необязательно.

Скиллами уже вовсю делятся. Есть репозитории и целые маркетплейсы — берёшь готовый скилл, кладёшь к себе, пользуешься. Кто-то собрал скилл для коммитов, кто-то для тестов, кто-то для разбора стектрейсов.

Тот же Anthropic держит публичный репозиторий готовых скиллов — github.com/anthropics/skills. Заходишь, берёшь что нравится, кладёшь к себе.

Единственное — смотри, что внутри. Обязательно. Это же инструкция, которую будет выполнять твой AI. Мало ли, вдруг там скилл «снеси базу и уверенно соври, что откатить нельзя».

С чего начать свою коллекцию, если руки чешутся:

• Ревью кода — тот, что мы собрали
• README — нормальное описание проекта вместо «TODO: написать потом»
• Коммиты — единый формат вместо «fix», «fix2» и «ну теперь точно fix»
• Разбор логов — берёт простыню ошибок и по-человечески говорит, что сломалось

Скилл, который пишет скиллы

А теперь то, от чего у меня в первый раз слегка вскипел мозг. Раз скилл — это просто файл с инструкцией, то можно сделать скилл, который… пишет другие скиллы.

Да, матрёшка. Скилл внутри скилла. Змея кусает свой хвост — и это, внезапно, очень удобно.

Такой скилл-создатель работает как редактор, который знает формат лучше тебя. Ты говоришь ему человеческими словами: «хочу автоматизировать вот это». Он задаёт уточняющие вопросы, сам пишет SKILL.md с правильными name и description (а мы уже знаем, что именно на описании все горят), раскладывает по папкам — и иногда даже прогоняет пару тестов: срабатывает ли твой новый скилл там, где должен.

Называется эта штука без изысков — skill-creator, официальный скилл от Anthropic, тех самых, кто делает Claude. В Claude Code он ставится одной строкой — /plugin install skill-creator@claude-plugins-official — а запускается командой /skill-creator. Дальше он всё делает сам: интервью, SKILL.md, папки, тесты.

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

Почему это не волшебная кнопка (и при чём тут ты)

Только не подумай, что скилл — это кнопка «сделать хорошо». Написал файлик, и AI сам гений. Нет.

Скилл хорош ровно настолько, насколько ты понимаешь, что в него заложить.

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

А вайб-кодер не знает, что там должно проверяться. Его скилл-ревьюер выйдет пустышкой: «проверь, чтобы всё было хорошо». Ну спасибо, дорогой, очень предметно.

Вот тебе неудобная правда: скилл не заменяет понимание. Он его умножает. Один раз разобрался, как надо — упаковал в скилл — работает за тебя вечно. Но чтобы упаковать что-то стоящее, надо сначала это стоящее знать.

Фундамент опять оказывается не гирей на ноге, а рычагом. Как всегда с AI.

Знать про скиллы и уметь на них жить — это разные вещи

Собрать один скилл-ревьюер — ерунда. Ты справишься за вечер, я в тебя верю.

А вот построить рабочий процесс, где десяток скиллов, агенты и твой фундамент складываются в машину, которая делает работу целой команды — это уже навык. Такой же, как программирование. Ему учатся.

JavaRush AI Native Developer — это три месяца, где ты не читаешь про скиллы, агентов и Claude Code, а собираешь на них реальный рабочий процесс. Рядом — ментор, который живёт в этом каждый день. Зайти можно с любого уровня. Но чем глубже фундамент, тем мощнее то, что ты соберёшь.

Нет фундамента? Начни с него — а скиллы лягут сверху: Java, Python, Web (HTML, CSS, JS), SQL, C#, C++, Kotlin, Docker, ChatGPT Apps.

Скилл экономит тебе десять минут в день. Умение строить на скиллах рабочий процесс — экономит годы.

Я потерял год, изображая Хаима на крыше. Тебе не обязательно.

Начни с одного файла. SKILL.md. Сегодня.

Лодка уже подплыла. Прыгай.