Самый простой способ создать скилл в Claude Code - не писать его с нуля. Сначала сделай задачу вместе с агентом в обычном чате и доведи результат до того, что тебя устраивает. Потом в этом же чате напиши: «сохрани это как скилл и назови так-то». Агент сам запишет порядок действий со всеми твоими правками в файл навыка. Дальше остаётся проверить в новом чате, что скилл запускается по смыслу и обновляет тот же документ, а не создаёт новый.
Почему скилл лучше делать из готового результата?
Скилл - это навык ИИ-агента: папка с файлом инструкций, который агент открывает, когда задача на него похожа. Большинство гайдов по запросу «как создать скилл в Claude» предлагают начать с формулировки задачи, входа и выхода. У тех, кто уже поработал с агентом, есть вариант короче.
Работа с агентом редко получается с первого ответа. Ты просишь, смотришь результат, говоришь, что поправить, и так до тех пор, пока не устроит. Эти круги правок и есть твой метод, и он уже записан в переписке.
На индивидуальном обучении я объяснял порядок так: несколько раз проходишь задачу с агентом руками, а когда получилось, говоришь «круто, а теперь сохрани это как скилл» и даёшь ему имя. Агент сохраняет и отвечает, что скилл готов.
Размер задачи значения не имеет. Скилл можно сделать на любое действие, которое ты один раз прошёл с агентом в одном чате: выгрузку, проверку, оформление документа. Это не обязательно что-то большое. Когда задача на десятки шагов, скилл тем более нужен, но начинать удобнее с маленьких.
Сохраняй в том же чате, где получилось
В новом чате агент начнёт с нуля: твоих правок из старого чата он не видел. Поэтому, как я говорю ученикам, это не обязательно делать именно в том же чате, но лучше там, где ты прошёл задачу и тебе понравился результат.
Если старый чат уже закрыт, путь всё равно есть. Открой готовый документ, приложи его к новому чату и перечисли словами, что было важно: формат, источники, чего не делать. Агент соберёт скилл по образцу, просто правок в нём будет меньше.
Перед сохранением проверь, где лежит работа. На том же занятии справка ученицы лежала в корне рабочей папки, вперемешку с другим. Первым запросом агент создал отдельный проект с номером и перенёс туда чат. Запрос на скилл я отправил ученице в Telegram, чтобы она вставила его в тот же чат, когда агент закончит текущую работу. Повторяемой задаче удобнее жить в своей папке: там лежит результат, его прошлые версии и сам скилл. Почему задачи не стоит смешивать в одном месте, разобрано в статье гигиена рабочей папки агента.
Запрос агенту: готовый текст
За основу взят запрос, который я надиктовал ученице на занятии: сохранить работу из чата как скилл с именем и при следующем вызове обновлять документ в том же формате. Список «В скилл запиши» я добавил сам, чтобы у скилла была структура:
Давай всю работу, которая в этом чате была проделана, сохраним в виде скилла
и назовём его «<название>».
В следующий раз, когда мне нужно будет получить обновлённую информацию,
я скажу: «запусти скилл <название>». Ты будешь делать обновление
в том же формате: сохранишь структуру документа и внесёшь только новое.
В скилл запиши:
- шаги, которые мы прошли, по порядку;
- мои правки по ходу работы как правила;
- где лежит итоговый файл и в каком он формате;
- чего не делать.Я так делаю в Claude Code. В Codex такой запрос тоже можно дать, но результат проверь: штатный путь по справке OpenAI - встроенный помощник $skill-creator, который спрашивает, что делает скилл, когда должен срабатывать и нужны ли ему скрипты. Ещё там есть запись навыка по показу (Record & Replay): агент смотрит, как ты проходишь задачу, и сам собирает черновик скилла. У Anthropic тоже есть скилл-помощник skill-creator.
Что агент создаёт на диске?
Документация Claude Code описывает файл так: в верхней части метаданные, которые говорят агенту, когда использовать скилл, ниже - инструкции, по которым он работает. Имя папки становится командой, а описание помогает агенту решить, когда загрузить скилл сам. Codex и ChatGPT, по их справке, сначала видят только имя и описание каждого скилла, а полный текст читают, когда выбрали его.
Где лежит файл, зависит от того, куда агент его положил:
| Где | Claude Code | Codex | Где работает |
|---|---|---|---|
| Личный скилл | ~/.claude/skills/<имя>/SKILL.md | ~/.agents/skills/<имя>/SKILL.md | во всех твоих проектах на этом компьютере |
| Скилл проекта | .claude/skills/<имя>/SKILL.md | .agents/skills/<имя>/SKILL.md | в этом проекте |
После сохранения попроси агента: «Покажи, где лежит скилл, и прочитай мне его описание». Описание стоит переписать словами, которыми ты сам будешь просить эту задачу. Почему скилл с абстрактным описанием не срабатывает, подробно разобрано в статье задача повторилась третий раз.
Как проверить, что скилл работает?
Имя скилла помнить не нужно. Ученице я так и сказал: через неделю, когда захочется обновить отчёт, просто напомни агенту, что вы выгружали, и попроси запустить тот скилл. Агент сам найдёт его, запустит и обновит файл.
Новый чат
Открой новый чат в той же папке проекта. Старый чат не подходит: там агент помнит задачу и без скилла.
Вызов по смыслу
Напиши так, как попросишь через неделю: «Мы на прошлой неделе делали справку по теме, запусти этот скилл». Агент должен назвать скилл, который нашёл.
Тот же файл
Открой папку проекта. Должен обновиться тот же документ: то же имя, свежая дата изменения, та же структура разделов. Если рядом появился новый файл с похожим именем, скажи агенту: «Внеси в скилл правило: обновлять существующий файл, новый не создавать».
Правки - в скилл
Если что-то в результате не так, правь в чате и в конце скажи: «Внеси эти правки в скилл». Без этой фразы правка останется в чате.
Как улучшать скилл после запуска?
Скилл с первого сохранения редко идеален. Первые два-три запуска покажут, чего в нём не хватает: забытый источник, лишний раздел, неверный формат дат. Каждый раз правило дописывается в тот же файл, и следующий запуск уже без этой ошибки.
Для задач посложнее я делаю подскилл, который проверяет результат основного и предлагает, как основной улучшить. Так устроены скиллы моей платформы мониторинга и контент-завода, их я показывал ученику на последнем занятии курса. Там же я показывал скилл, который публикует статью через браузер.
Порядок, который я советую: сначала один рабочий скилл, потом проверяющий. Если взять готовый чужой скилл и дописывать его под себя, обновление автора может затереть твои правки. Как этого избежать, разобрано в статье как обновить скилл и сохранить свои правки.
Следующий шаг: скилл по расписанию
Цепочка выходит такая: руками в чате, потом скилл, потом расписание. В приложении Claude Code задачу по расписанию, по документации, можно создать, описав её словами в любом чате, без формы в меню. Я свои автозадачи так и создаю: пишу в обычном чате, что и когда запускать. Одна оговорка из документации Claude Code: личные скиллы из домашней папки не загружаются в облачных сессиях, их видят задачи, которые работают на твоём компьютере.
На корпоративном обучении этот порядок проходят на рабочих файлах компании. Как я писал в посте о втором потоке обучения для одной компании: задачу, которая повторяется каждую неделю, агент сохраняет как скилл и дальше делает по одной команде. С обучения уносят наработки, которые завтра можно запустить на свежих данных.
Если хочешь пройти этот путь на своей задаче с разбором каждого шага, на обучении работе с ИИ-агентами автозадачи - часть занятия про безопасность и автономность: сводки по утрам, напоминания о сроках, разноска документов. Что меняется, когда агент работает без тебя, и как ловить тихие поломки, разобрано в статье автозадачи: агент работает без тебя.
Частые вопросы
Частые вопросы
Главный вывод
Сохранять скилл стоит в тот момент, когда результат тебе понравился, пока все правки ещё в чате. Чистый лист и синтаксис файлов для этого не нужны.
Практический шаг на сегодня: найди чат, где агент на прошлой неделе сделал для тебя что-то полезное, и напиши в нём запрос из раздела выше. Через неделю проверь, обновится ли тот же файл.
Какая твоя задача первой станет скиллом: отчёт, справка или проверка документа?
Источники
- Extend Claude with skills - SKILL.md, где хранятся скиллы и как агент выбирает их по описанию, документация Claude Code
- Build skills - как ChatGPT и Codex загружают скиллы, где Codex их хранит, skill-creator и Record & Replay, ChatGPT Learn
- Schedule recurring tasks in Claude Code Desktop - задачи по расписанию и создание словами в чате, документация
- Agent Skills - открытый формат скиллов для агентов
