AI-скиллы для ИИ-агентов: что это и как создать свой SKILL.md

Если вы работаете с ИИ-агентами — Codex, Claude Code, Hermes или OpenClaw — у вас наверняка есть повторяющиеся задачи, которые нейросети нужно постоянно разжёвывать: как оформить код по правилам проекта, подготовить README, разобрать ошибку в логе. Есть способ заставить ИИ запомнить, как выполнять такие задачи навсегда: он называется AI-скиллы. Разбираем, что такое скилл ии агента, как устроен файл SKILL.md, как создать скилы для ии агентов своими руками и где брать готовые навыки — включая хаб OpenClaw.

01. Что такое скиллы для ИИ-агентов

Разработчики добавляют в проекты файл README, чтобы человек понял, что это за проект и как им пользоваться. Скиллы работают похожим образом, только для ИИ-агентов: это инструкция по решению конкретной задачи, которая хранится в файле SKILL.md внутри специальной папки.

По логике навыки напоминают системные промпты и кастомные команды, но только на первый взгляд:

• Системные промпты — глобальные правила, которые нейросеть применяет всегда и не может игнорировать: «отвечай коротко», «ссылайся на источники».

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

• Скиллы — агент видит их постоянно, как системные промпты, но применяет только когда уместно, как кастомные команды. Нейросеть сама решает, когда применить навык: если инструкция написана корректно, вызывать её вручную не нужно. Качественным скилл можно считать, когда агент сам использует его в 90% релевантных задач.

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

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

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

• SKILL.md (обязательный) — инструкция в Markdown + блок с описанием, когда применять навык.

• scripts/ — исполняемый код (Python, Bash) для автоматизации сложных задач: пройтись по ссылкам, собрать список файлов, преобразовать CSV в Markdown.

• references/ — документация для ИИ: шаблоны, правила оформления, примеры хороших результатов.

• assets/ — шаблоны, шрифты, иконки.

Внутри SKILL.md тоже есть своя структура, без которой навык будет работать некорректно.

YAML frontmatter

Вверху файла — блок метаданных с двумя обязательными полями: name (название навыка, по нему агент отличает один скилл от другого) и description (описание задачи — подсказка, по которой нейросеть понимает, когда использовать навык). Блок выделяется тремя дефисами сверху и снизу — этот формат называется YAML frontmatter:

```

---

name: readme-writer

description: Используй этот скилл, когда нужно собрать или обновить README-файл для проекта.

---

```

По желанию добавляются version — для отслеживания версий, и tags — для поиска в каталогах и группировки.

Тело инструкции

После блока метаданных идёт основная инструкция. Её пишут в Markdown, чтобы нейросеть лучше понимала структуру. Единого стандарта нет, но часто встречаются разделы: название скилла для человека, «Когда использовать», «Как работать» (порядок действий), «Правила» (ограничения) и «Формат ответа».

Чем конкретнее description — тем лучше срабатывает автотриггеринг: агент читает описание, сопоставляет с задачей и применяет навык только если подходит. «Помогает с программированием» — плохо, агент проигнорирует. «Используй, когда пользователь просит простыми словами объяснить фрагмент кода или сообщение об ошибке» — хорошо, сработает.

03. Как создать скилл: пошагово

Шаг 1. Выберите задачу

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

Шаг 2. Создайте папку

Папку называют коротко, латиницей, через дефисы — например, readme-writer. Она может лежать в общей директории навыков агента или внутри конкретного проекта (тогда скилл будет виден только там).

Шаг 3. Напишите YAML-блок

В файле SKILL.md (именно так, не SKILL.md.txt) прописываете name и description. Их имена — всегда на английском, а сама инструкция может быть на русском.

Шаг 4. Напишите тело

Инструкция с Markdown-разметкой: что делать, в каком порядке, чего избегать, как оформить результат. Не обязательно писать всё руками: можно объяснить задачу ИИ-чату и попросить черновик, но потом важно прочитать и поправить.

Шаг 5. Добавьте ресурсы

Если задаче нужны скрипты или шаблоны — кладёте их в scripts/ и references/ и прописываете в SKILL.md, когда агент должен к ним обращаться. Важно не перегружать папку: лишние файлы забивают память агента и путают его.

Шаг 6. Проверьте

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

04. Где брать готовые скиллы: ClawHub и другие

Не все навыки нужно создавать с нуля. У популярных агентов есть свои хабы: OpenAI Codex (github.com/openai/skills), Anthropic для Claude Code, Google Gemini, а у OpenClaw — ClawHub (clawhub.ai). Навыки можно брать из чужих экосистем: скилл от Claude Code поставить в Codex или в OpenClaw — формат SKILL.md универсален и не привязан к одному агенту.

Кроме официальных хабов есть маркетплейсы: skills.sh (более 573 тыс. скиллов), Context7 Skills (реестр из GitHub, 43 тыс.), LobeHub (323 тыс. навыков под документы, маркетинг, дизайн и разработку).

Способы установки:

• Командой агента — например, у Claude Code: /plugin marketplace add, потом /plugin install.

• Командой маркетплейса — npx skills add, npx ctx7 skills install (понадобится Node.js).

• По промпту — просто просите агента установить навык: нейросеть сама найдёт инструкцию.

• Ручное скачивание — скачали репозиторий, положили папку туда, где агент ищет скиллы.

05. Скиллы в OpenClaw: как это работает

OpenClaw — опенсорс-платформа ИИ-агентов, и скиллы здесь — часть её экосистемы: openclaw skills — это навыки, которые видят агенты на вашёй установке, а openclaw hub (ClawHub) — каталог, откуда их ставят. Openclaw workspace — это рабочая папка агента, где лежат SKILL.md и ваши проекты: положили навык в нужную директорию — агент начинает им пользоваться. openclaw tools — инструменты, которые агент вызывает из скиллов: API, скрипты, интеграции.

По сути, скилл ии агента в OpenClaw — это тот же SKILL.md, что и в других экосистемах, поэтому миграция простая: скиллы от Claude, Codex или с маркетплейсов ставятся в openclaw без переписывания.

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

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

• Чем скилл отличается от системного промпта? Системный промпт задаёт общие правила, которые работают всегда. Скилл решает узкую задачу и применяется, только когда уместно.

• Скиллы работают только с Claude? Нет. Впервые появились в Claude Code, но сейчас поддерживаются Codex, Hermes, OpenClaw и другими. Навыки не привязаны к экосистеме.

• Сколько скиллов ставить? Жёсткого лимита нет, но десятки лишних навыков забивают память агента и запутывают его. Лучше несколько качественных.

• Можно ли сделать скилл, вызывающий внешние API? Да, если агент умеет запускать скрипты: кладёте их в scripts/ и прописываете в SKILL.md, как пользоваться.

• Как проверить триггеринг? Дайте несколько похожих запросов: прямой, короткий, переформулированный. Если агент стабильно выбирает скилл — description написан хорошо.

Научите своего агента новым навыкам

AI-скиллы — это способ один раз объяснить агенту, как выполнять повторяющуюся задачу, и больше не тратить токены на переобъяснения. Главное — не запихивать в навык всё сразу: хороший скилл решает одну понятную задачу и точно описывает, когда его применять. Чем яснее description, тем лучше агент поймёт, в какой момент подключить инструкцию. В OpenClaw скиллы — часть платформы: готовые из ClawHub, свои под ваши процессы, с инструментами и скриптами. Настроить агента с нужными навыками — это то, что мы делаем в Right Claw: собираем вашего агента на OpenClaw, подключаем сервисы и учим его вашим правилам через скиллы. Первая неделя — бесплатно.