Перед тем как обновить скилл, сохрани его рабочую копию и свои изменения. Затем сравни новую версию со старой, перенеси нужные требования и проверь результат на знакомой задаче. Заменять папку сразу поверх рабочей рискованно: вместе с устаревшими шагами могут исчезнуть твои ограничения, шаблоны и правила сохранения файлов.
Скилл - инструкция для ИИ-агента. Она может включать не только SKILL.md, но и связанные скрипты, примеры и шаблоны. Поэтому обновлять иногда приходится целую папку. Устройство скилла описано в спецификации Agent Skills, а отличие от подключения к внешнему сервису - в статье скилл и MCP.
Как обновить скилл: где искать новую версию?
На одном из занятий меня спросили, обогащается ли установленный скилл сам. Мы сравнили локальную инструкцию с источником на GitHub. Такая проверка показывает различия между файлами; пользу новой версии ещё предстоит проверить отдельно.
Для своей установки выясни следующее:
| Как появился скилл | Что проверить перед заменой |
|---|---|
| Вручную скопировал папку | Откуда взята копия и где автор публикует изменения |
| Получил через аккаунт | Где редактируется исходник и откуда приходит синхронизация |
| Установил вместе с плагином | Какой каталог поставляет плагин и включено ли обновление |
Например, справка Claude Code различает локальные скиллы и скиллы, загружаемые из аккаунта. В плагинах автообновление зависит от настроек каталога. Обновлённая копия на диске и версия, уже загруженная в текущую сессию, могут различаться. Эти условия сверены 19 октября 2026 года; для другого инструмента нужен его собственный порядок обновления.
Агенту можно дать такой запрос:
Пока ничего не меняй. Найди скилл [название], которым мы пользуемся.
Покажи путь или источник, способ установки и связанные файлы.
Укажи, какая копия используется в этом чате и как она обновляется.
Если источник или загруженную версию установить не удалось,
скажи об этом прямо.Сохрани свои требования и сравни изменения
Допустим, ты доработал чужой скилл для разбора задач: запретил создавать встречи без проверки календаря и выбрал папку для отчёта. Это условный пример. При копировании новой версии поверх старой оба правила могут потеряться. А если заменить только SKILL.md, ему может не хватить нового шаблона, на который теперь ссылается инструкция.
Сохрани рабочую папку скилла целиком. Рядом запиши, что менял и зачем. Причина особенно нужна у ограничений: следующий редактор должен понимать, почему перед отправкой требуется просмотр, даже если новая инструкция выглядит проще без него.
Попроси сравнение по этим пунктам:
- Когда скилл запускается и не начнёт ли он срабатывать на другие запросы.
- Какие файлы и сведения теперь нужны на входе.
- Какие действия добавились, особенно запись во внешние системы и отправка сообщений.
- Куда сохраняется результат и каким должен быть его формат.
- Что скилл проверяет перед завершением и когда обязан остановиться.
Сводка «инструкция стала подробнее» для решения бесполезна. Отдельно отметь появившуюся отправку готового черновика или второй обязательный файл. Если появился исполняемый скрипт, выясни его назначение и доступы до запуска.
Если с агентами работает целая команда, порядок обновления инструкций стоит обсудить вместе с её рабочими сценариями. Программу моего корпоративного обучения по ИИ адаптируем под задачи участников, в том числе работу с ассистентами и агентами.
Как перенести свои правки в новую версию?
Пусть агент перенесёт каждое твоё требование и покажет, где оно оказалось. Часть правил могла уже появиться у автора. Тогда одинаковый абзац можно убрать, но сначала сравни условия: проверка перед созданием файла и проверка перед отправкой клиенту относятся к разным действиям.
Если новая версия разрешает самостоятельную отправку, а твоё правило требует просмотра, конфликт нужно решить явно. Агент должен показать сохранённое ограничение и место, где изменил новую инструкцию. Решение, зависящее от порядка работы компании, принимает владелец процесса.
Запиши источник новой версии, дату сравнения, перенесённые требования и способ вернуть прежний вариант. Для общей инструкции команды назначьте одного владельца рабочей копии. Иначе несколько людей могут независимо заменить её, а потом будет трудно понять, чьи изменения действуют.
Проверь обычную задачу и случай остановки
Сохрани запрос и результат старой версии. Затем повтори запрос с новой, убедившись, что используется нужная копия. Если порядок применения изменений зависит от сессии, проверь его в справке своего инструмента. Два запуска одной и той же копии не дадут сравнения версий.
Если скилл отправляет сообщения или меняет внешние данные, проводи проверку в тестовом окружении либо ограничь оба запуска подготовкой черновика. Обезличенные входные данные сами по себе не отменяют отправку.
Сравни содержание, формат, место сохранения и обязательные проверки. Новые вопросы могут быть полезны, если прежняя версия угадывала недостающие сведения. Но исчезнувшее ограничение нельзя считать улучшением только потому, что работа закончилась быстрее.
Во втором запросе убери обязательный файл или попроси действие за пределами разрешённого. Посмотри, назвал ли скилл причину остановки и что предложил дальше. Один удачный пример не проверяет эту часть инструкции и не гарантирует работу во всех будущих случаях. Для командного скилла сохраняйте характерные запросы как набор проверок на следующее обновление.
Заменяй рабочую версию, когда различия понятны, свои требования сохранены и нужные задачи проходят проверку. Если источник неясен или проверить результат пока нельзя, отложи замену. Когда перестал работать внешний сервис, сначала исправь зависимый шаг; новые возможности можно добавлять отдельным изменением. Такой ремонт описан и в статье инструкция устарела. Способ возврата к предыдущему состоянию разбирается в материале как откатить изменения агента.