Вы уже настроили агента. Он знает ваш проект, помнит контекст, работает нормально. А потом вы переходите в другой инструмент - и объясняете всё заново. Или приходит новый человек в команду, и снова длинный онбординг-промпт, который "звучит всеобъемлюще, но расплывчато в деталях". Именно в тех деталях, которые реально предотвращали баги. Есть способ это починить - и он называется скилл. Но сначала важно понять, почему контекста самого по себе недостаточно.
Что узнаете из статьи:
- Почему "процедурный долг" тормозит работу с AI даже при хорошем контексте
- Чем скилл принципиально отличается от промпта
- Три конкретных примера скиллов: факт-чек, голос, браузерное тестирование
- Как ранбуки объединяют скиллы в цепочки
- И главное: что можно сделать с этим уже завтра
Проблема, которую все чувствуют, но не могут назвать
Команда настроила cursor rules. Всё работало. Затем начали использовать Claude Code - правила не перенеслись. Один инженер теперь поддерживает два файла, они расходятся. Новый контрактор получает длинный онбординг-промпт. Команда не тупая, контекст есть. Нет портативного способа переносить саму процедуру.
Это не проблема памяти агента. Это проблема архитектуры.
Есть концепция Open Brain - когда агент знает ваши проекты, заметки, историю. Мощная штука. Но Open Brain отвечает на вопрос "что". А вопрос "как" - как проверять факты, как писать в вашем голосе, как тестировать интерфейс - это уже другое.
Это и есть "процедурный долг".
Четыре симптома того, что он у вас накопился:
1. Повтор объяснений. Вы рассказываете агенту одно и то же в начале каждой сессии.
2. Инструментная привязка. Процедура живёт только в Cursor или только в Claude Code - но не в обоих.
3. Онбординг как потеря. Новый человек (или новая сессия) теряет всё неочевидное - именно то, что стоило дорого.
4. Дрейф инструкций. Два файла, два инструмента, две версии "правды" - и они расходятся.
(А такое бывает чаще, чем кажется - особенно в командах, где AI используют несколько человек.)
Что такое скилл и чем он отличается от промпта
Скилл - это не промпт. Точнее, не просто промпт.
Промпт говорит агенту, что сделать. Скилл говорит агенту, как это делать - воспроизводимо, с проверкой, в любом инструменте.
Технически скилл - это папка с файлом skill.md. Внутри семь обязательных элементов:
- Триггер - когда скилл включается
- Антитриггер - когда его не надо применять
- Задача - что именно делать
- Инструменты - какие команды и ресурсы использовать
- Границы - что выходит за рамки скилла
- Формат вывода - как выглядит результат
- Верификация - как агент проверяет, что всё сделано правильно
Последний пункт - ключевой. Именно верификация отличает скилл от "записки на салфетке". Агент не просто выполняет процедуру, он подтверждает результат по заранее определённым критериям. Это контракт, вернее даже не контракт - это чеклист с зубами.
Скиллы работают в Claude Code, Cursor и Codex. Это открытый стандарт: Anthropic выпустила его в декабре 2025, и за четыре месяца репозиторий anthropics/skills набрал 62 000 звёзд. Среди партнёров - Atlassian, Figma, Canva, Stripe, Notion.
Когда скилл не работает: если процедура слишком специфична для одной задачи и не повторяется. Делать скилл из разового запроса - избыточно.
Кстати, если тема интересна - в Telegram-канале пишу о подобном регулярно: инструменты, лайфхаки, конкретные сценарии использования нейросетей в жизни и бизнесе. Там проще задать вопрос и не ждать следующей статьи.
Три примера, которые объясняют лучше теории
Абстракции хороши, но давайте по-конкретному.
Скилл факт-чека. Агент пишет статью. Внутри - цифры, исследования, ссылки. Скилл факт-чека запускается автоматически перед финальным выводом: агент проверяет каждое фактическое утверждение, помечает непроверенные, предлагает источники. Верификация - список утверждений со статусом подтверждено / под вопросом / требует источника. Без скилла это либо ручная работа, либо надежда, что агент сам разберётся.
Скилл голоса. У меня был случай: я настраивал агента для написания постов, описал свой стиль в промпте - разговорный, с иронией, без пафоса. Работало несколько сессий, потом "голос" начал плыть. Скилл голоса решает это иначе: не описание стиля, а процедура его проверки. Агент пишет черновик, затем прогоняет его через чеклист: нет ли безличных конструкций, есть ли самоправки, соблюдается ли ритм абзацев. Казалось бы, можно просто добавить в промпт - на деле без верификации инструкция размывается за 3-4 итерации.
Скилл браузерного тестирования. Агент написал компонент. Скилл запускает набор проверок: открывает страницу, проходит по сценарию пользователя, фиксирует ошибки консоли, делает скриншот. Верификация - отчёт с результатами тестов. Это воспроизводимо в любой сессии и в любом инструменте.
Ранбуки: когда скиллов становится несколько
Один скилл - это хорошо. Цепочка скиллов - это система.
Ранбук - это последовательность вызовов нескольких скиллов для решения составной задачи. Например: "опубликовать статью" - это не один шаг. Это факт-чек, затем проверка голоса, затем форматирование, затем генерация обложки, затем постинг. Каждый шаг - отдельный скилл. Ранбук связывает их в порядке.
В первом релизе Open Skills было 31 скилл в 7 категориях и 7 готовых ранбуков. Это не случайная цифра - 7 ранбуков покрывают самые частые сценарии: написание и публикация контента, код-ревью, онбординг, тестирование, документация.
Ранбук не просто экономит время. Он убирает "забыл запустить проверку" из уравнения.
Скоп: личный и проектный
Скиллы бывают двух видов по области действия.
Глобальные (personal/global) - живут в ~/.claude/skills/ и доступны во всех проектах. Это ваши личные процедуры: голос, стиль, способ проверки фактов, утренний брифинг.
Проектные (local) - живут в .claude/skills/ внутри конкретного проекта. Это процедуры команды или продукта: как тестировать этот компонент, как форматировать этот тип данных, как деплоить в эту среду.
Исследование июня 2026 года: из 100 популярных репозиториев с CLAUDE.md или AGENTS.md у 91% нашли "конфигурационные запахи". Самый частый - Context Bloat (42%): люди пытаются запихнуть процедуры в контекстный файл вместо скиллов. Anthropic рекомендует держать CLAUDE.md в пределах 200 строк - процедуры в него не влезают и не должны.
Разделение скопа решает и командную проблему: личный голос не попадает в репозиторий, командные процедуры не размазаны по личным настройкам.
Флайвил: как скиллы накапливаются сами
Самое интересное - не то, как создать первый скилл. А то, как система начинает пополняться без усилий.
Session-to-skill extractor - это скилл, который запускается в конце рабочей сессии. Он анализирует, что агент делал, и спрашивает: "Мы несколько раз повторили одну процедуру - сохранить её как скилл?"
Вы отвечаете "да" - скилл создаётся автоматически: триггер, задача, верификация. Один клик.
Это флайвил. Каждая сессия потенциально добавляет новый скилл. Библиотека растёт. Агент становится точнее не потому что "умнеет" - а потому что у него всё больше проверенных процедур.
Типичные ошибки при работе со скиллами
Слишком широкий триггер. Скилл включается где не надо, мешает нормальной работе. Антитриггер должен быть таким же чётким, как триггер.
Нет верификации. Скилл без чеклиста проверки - это просто промпт в папке. Агент выполнит процедуру, но не подтвердит результат.
Процедура в CLAUDE.md. Context Bloat - самая частая ошибка по данным исследования. Инструкции "как делать" не должны быть в контекстном файле.
Дублирование между global и local. Один скилл в двух местах расходится - та же проблема, что с cursor rules и Claude Code.
Пропуск онбординга скилла. Скилл создан, но никто в команде не знает, что он существует. Документация скиллов - не опциональная часть.
Когда стоит разобраться в этом глубже
Если у вас уже есть агент в работе - и вы объясняете ему одно и то же больше двух раз - это прямой сигнал. Не потому что агент плохой, а потому что повторяющаяся процедура ещё не стала скиллом.
Порог входа здесь низкий. Первый скилл можно написать за 20 минут.
Что конкретно делать: взять любую инструкцию, которую вы даёте агенту регулярно. Написать skill.md с семью разделами. Положить в ~/.claude/skills/. Всё. Подробности - в паре бесплатных мест, о которых в конце статьи.
Если хочется не просто читать про AI, а реально его применять, у меня есть несколько мест, где это можно делать вместе.
Начать стоит с Telegram-канала. Это наш основной ресурс, где разбираем новые инструменты, кейсы автоматизации и приёмы, которые можно применить уже завтра.
Если зайдёт, залетайте в AI BASE. Это закрытое сообщество, где я делюсь личными наработками по автоматизации, вайб-кодингу и нейросетям.
А если хочется прямо сейчас сесть и попробовать руками, есть два бесплатных курса с нуля: по n8n для автоматизации без кода и по Claude Code для разработки в связке с AI.
FAQ
Чем скилл отличается от промпта?
Структурой и верификацией. Промпт - инструкция. Скилл - процедура с чеклистом проверки результата и чётким триггером запуска.
Как создать скилл для Claude Code?
Создаёте папку в ~/.claude/skills/имя-скилла/, внутри файл skill.md с семью разделами: триггер, антитриггер, задача, инструменты, границы, формат вывода, верификация. Claude Code подхватывает автоматически.
Как скиллы работают в Cursor и Codex?
Через тот же открытый стандарт. Папка .claude/skills/ в проекте читается всеми совместимыми инструментами. Anthropic выпустила стандарт в декабре 2025 именно для переносимости.
Что такое ранбук для AI агента?
Ранбук - это упорядоченная цепочка скиллов для составной задачи. Грубо говоря, скрипт из скриптов. Например, пайплайн "написать и опубликовать статью" - это 5-6 скиллов в определённом порядке.
Нужны ли скиллы, если я работаю один?
Да, и особенно. Вы сами - "новый контрактор" в каждой новой сессии. Скиллы дают вашему агенту память о процедурах, а не только о контексте.