Как создать первый skill для ИИ-агента без программирования

Короткий ответ

Выберите одну повторяемую работу с проверяемым результатом. Попросите ИИ расспросить вас о входах, шагах, критериях готовности и стоп-условиях.

Сохраните процедуру в папке с SKILL.md: нужны name, description и инструкция. В новом чате проверьте три случая: нужная задача, чужая задача и недостающие данные.

Что такое skill простыми словами

Пакет навыка, или skill, — не новая модель и не сотрудник. Это переносимый регламент для совместимого ИИ-агента.

Он говорит, когда применять процедуру, что прочитать, какие шаги сделать, как проверить результат и когда позвать человека.

Открытая Agent Skills Specification задаёт минимум: папка и SKILL.md с метаданными и инструкцией.

Справки, шаблоны и скрипты необязательны. Спецификация проверена 2026-08-30.

Главная польза папки не в расширении имени файла. Она отделяет процедуру от конкретного разговора. Удачный запрос больше не остаётся в чате одного маркетолога: его можно прочитать, обсудить, обновить и проверить на свежей задаче.

Переносимый формат не означает одинаковую установку или результат. Среды по-разному находят skills, дают доступ к файлам и выполняют скрипты.

В этом уроке мы создаём ядро процедуры. Способы установки разбираются в следующем материале.

Какую работу упаковать первой

Не начинайте со «всего маркетинга». Первый skill должен отвечать за один наблюдаемый результат.

Подходят процессы, где:

• задача уже выполнялась вручную хотя бы несколько раз;
• входы можно назвать;
• шаги в основном повторяются;
• готовность можно проверить;
• понятны ситуации, когда нужно остановиться;
• ошибка обратима и итог принимает человек.

Хорошие первые кандидаты: проверить недельный отчёт, собрать бриф по шаблону, привести заметки встречи к списку решений, проверить карточку товара по обязательным полям.

Плохой кандидат: «принимай все маркетинговые решения». У него нет одного результата, границ доступа и простого критерия готовности.

Не начинайте с отправки клиентам или изменения бюджета. Сначала нужен черновик и человеческая проверка.

Цена поспешности проста: папка будет выглядеть как стандарт, хотя внутри останутся недоговорённости. Команда начнёт повторять не лучший процесс, а случайный удачный диалог.

Интервью: достаньте процедуру из головы

Откройте чат и дайте ИИ роль интервьюера процесса. Попросите задавать вопросы по одному и не писать skill до подтверждения резюме.

Помоги превратить мою повторяемую работу в первый Agent Skill.

Сначала проведи интервью. Задавай по одному вопросу и выясни:
1. какой конкретный результат должен появиться;
2. в каких запросах эту процедуру нужно применять;
3. какие входы обязательны и где они находятся;
4. какие шаги выполняются всегда;
5. как проверить готовность результата;
6. когда нужно остановиться и обратиться к человеку;
7. что skill никогда не должен делать.

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

Процесс: проверка недельного маркетингового отчёта.

Сильная карта процесса говорит не только «сравнить показатели». Она называет входы, порядок и наблюдаемую проверку.

Например: сначала сверить период, затем обязательные колонки и итоги. Только после этого можно описывать отклонения.

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

Из карты процесса в минимальную папку

Назовём skill weekly-marketing-review. Имя написано строчными латинскими буквами и дефисами и совпадает с названием папки — это требование спецификации. Полная минимальная структура выглядит так:

weekly-marketing-review/
└── SKILL.md

Создайте папку и сохраните в SKILL.md следующий текст:

---
name: weekly-marketing-review
description: Проверяет черновики недельных маркетинговых отчётов по выгрузкам. Используй, когда пользователь просит собрать или проверить недельный отчёт по расходам, лидам и продажам.
---

## Процедура проверки недельного маркетингового отчёта

## Цель

Подготовить проверяемый черновик отчёта. Не принимать решения
о бюджетах и не публиковать результат.

## Перед началом

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

Ожидаемая нормализованная схема:
- expenses.csv: date, channel, spend_rub;
- leads.csv: date, channel, leads;
- sales.csv: date, channel, sales_count.
Одна строка описывает один канал за один день; дата записана как
2026-08-17. Если названия или единицы отличаются, запроси явное
сопоставление.

## Порядок работы

1. Проверь, что все файлы относятся к одному периоду.
2. Проверь обязательные колонки и отсутствие смешанных единиц.
3. Сгруппируй значения по каналу суммой за общий период.
4. Сверь полученные суммы с итогами исходных файлов, если они есть.
5. Если период, колонки или суммы не сходятся, перечисли
   расхождения и остановись.
6. Если проверки пройдены, собери таблицу по каналам.
7. Назови три заметных отклонения без выдумывания причин.
8. Для каждого вывода укажи исходный файл или строку данных.

## Результат

- статус входных проверок;
- таблица «канал — расходы — лиды — продажи»;
- наблюдаемые отклонения;
- вопросы и недостающие данные;
- пометка «черновик, требуется проверка CMO».

## Запрещено

- придумывать отсутствующие числа или причины;
- менять рекламные бюджеты;
- отправлять или публиковать отчёт;
- обрабатывать персональные данные, если они случайно попали во входы.

Это синтаксически корректный минимальный skill. YAML-frontmatter объясняет назначение, а тело задаёт процедуру.

description описывает действие и ситуации применения. По ней среда может определить релевантность skill (Agent Skills Specification, проверено 2026-08-30).

Пример

Продолжим вымышленный сценарий российского интернет-магазина «Тёплый дом». Это учебный пример, не реальный кейс.

Маркетолог передаёт три обезличенных файла за 17–23 августа. В выгрузке расходов период заканчивается 22 августа.

Без skill чат мог бы сразу перейти к выводам. Процедура требует сначала сверить период.

Правильный результат первого запуска:

Статус: ОСТАНОВКА.

Проверка периода не пройдена:
- CRM: 17–23 августа;
- Метрика: 17–23 августа;
- расходы: 17–22 августа.

Отчёт и выводы не сформированы. Нужна выгрузка расходов
за 23 августа либо подтверждение другого общего периода.

Это не провал skill. Наоборот, он воспроизвёл важную границу процесса. Польза проявилась не в объёме текста, а в отказе делать вывод по несопоставимым входам.

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

Для позитивного теста заранее нормализуйте три входа. Минимальный пример ниже использует один день; в реальной неделе добавьте строки в той же схеме.

FILE: expenses.csv
date,channel,spend_rub
2026-08-17,telegram,12000
2026-08-17,vk,15000

FILE: leads.csv
date,channel,leads
2026-08-17,telegram,48
2026-08-17,vk,60

FILE: sales.csv
date,channel,sales_count
2026-08-17,telegram,9
2026-08-17,vk,11

Ожидание: агент суммирует каждую метрику по каналу, не смешивает рубли и количества, ссылается на три файла и оставляет решение о бюджете CMO.

Практика: три теста в новом чате

Старый разговор уже содержит интервью и подсказки. Поэтому откройте новую сессию в среде, где skill установлен или доступен, и зафиксируйте результаты в skill-test.md.

Тест 1. Должен сработать

Запрос: «Проверь недельный маркетинговый отчёт по этим трём обезличенным выгрузкам». Ожидание: агент применяет порядок из skill, начинает с периода и колонок, не прыгает к выводам.

Тест 2. Не должен сработать

Запрос: «Напиши поздравление партнёру с годовщиной компании». Ожидание: процедура отчёта не вмешивается. Если агент пытается искать выгрузки, description слишком широкая или установка настроена неверно.

Тест 3. Должен остановиться

Передайте два файла вместо трёх. Ожидание: агент называет отсутствующий вход и не достраивает числа. Если он всё равно создаёт отчёт, усилите разделы «Перед началом» и «Запрещено».

Qwen Code рекомендует тестировать skill запросом, совпадающим с description. При проблеме нужно проверить путь и YAML (Qwen Code Docs, обновлено 2026-08-17).

Документация проверена 2026-08-30. Тестовая карточка выше остаётся независимой от бренда.

Когда расширять папку

Не добавляйте файлы ради солидности. Расширяйте skill, когда тест показал конкретную повторяющуюся проблему:

weekly-marketing-review/
├── SKILL.md
├── references/
│   └── required-columns.md
├── assets/
│   └── report-template.md
└── scripts/
    └── check-totals.py

• references/ нужен для правил и справок, которые читаются не всегда.
• assets/ хранит копируемый шаблон результата.
• scripts/ оправдан для точной повторяемой проверки, которую опасно каждый раз пересчитывать свободным текстом.

Спецификация считает эти директории необязательными. В поддерживающих средах ресурсы могут загружаться по необходимости.

Claude, например, документирует поэтапную загрузку метаданных, инструкции и ресурсов (Claude Platform Docs, проверено 2026-08-30).

Это текущая особенность продукта, а не обещание одинакового поведения везде.

Ограничения

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

Skill не гарантирует автоматическое срабатывание. Description, путь установки, версия клиента и доступные инструменты влияют на поведение. Поэтому храните тестовые запросы рядом с процедурой и повторяйте их после изменения.

Skill не получает права сам. Доступ к CRM, отправке сообщений или изменению бюджетов задаёт среда. Для первого пилота оставьте чтение разрешённых файлов и создание черновика.

Наконец, результат остаётся вероятностным, если его формирует языковая модель. Детерминированные суммы лучше проверять формулой или скриптом, а выводы — человеком, который отвечает за решение.

Что делать

1. Выберите один процесс с обратимой ошибкой и названным владельцем.
2. Проведите интервью и подтвердите карту процесса.
3. Создайте папку, скопируйте минимальный SKILL.md и адаптируйте только факты своего процесса.
4. Проведите три теста в новой сессии и заполните skill-test.md.
5. Исправляйте описание, шаги или стоп-условия по наблюдаемой ошибке, а не по вкусу.
6. Добавляйте references, assets или scripts только после выявленной необходимости.
7. Перед командным использованием назначьте владельца skill и дату следующей проверки.

FAQ

Нужно ли уметь программировать, чтобы создать свой первый skill?

Нет. Минимальный skill — это папка и текстовый файл SKILL.md с двумя обязательными полями метаданных и инструкцией на обычном языке. Python, Git и API не нужны: папку и файл можно создать самому или попросить об этом агента. Каталог scripts/ спецификация считает необязательным, поэтому на первом skill он только усложняет работу.

Сколько файлов нужно, чтобы skill заработал?

Одного. Это SKILL.md: YAML-frontmatter с обязательными name и description, а дальше текст процедуры — цель, входы, порядок работы, результат и запреты. Имя пишется строчными латинскими буквами с дефисами и совпадает с названием папки. Каталоги references/, assets/ и scripts/ по спецификации необязательны, и добавлять их стоит только после того, как тест выявил конкретную повторяющуюся проблему.

Что делать, если агент не применяет skill в новом чате?

Проверьте три вещи: формулировку description, путь установки и корректность YAML-frontmatter. Документация Qwen Code советует тестировать skill запросом, совпадающим с description, а при сбое смотреть путь и метаданные. Обратная ошибка тоже показательна: если агент тянет процедуру в постороннюю задачу вроде поздравления партнёру, description слишком широкая и её нужно сузить.

Можно ли поручить skill отправку отчёта клиенту или изменение бюджета?

Нет. Skill не получает прав сам: доступ к CRM, отправке сообщений и рекламным бюджетам задаёт среда, а не текст файла. Для первого пилота оставьте чтение разрешённых файлов и подготовку черновика, а решение — человеку, который за него отвечает. Раздел «Запрещено» в SKILL.md прямо фиксирует, что процедура не публикует результат и не меняет бюджеты.

Будет ли один skill одинаково работать во всех ИИ-агентах?

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

Как понять, что процесс ещё не готов к упаковке в skill?

Главный признак — ответы вроде «обычно видно по ситуации». Пока владелец не может назвать входы, порядок шагов, проверку готовности и стоп-условие, интервью не закончено, а файл лишь закрепит недоговорённость как стандарт. Второй признак — спор о самом определении метрики: если команда не сходится в том, что считать продажей, сначала нужен владелец метрики, а не папка со skill.

Источники

• Agent Skills Specification — минимальная структура, метаданные и необязательные ресурсы; проверено 2026-08-30.
• Agent Skills — Qwen Code Docs — обнаружение, тест и отладка skill; обновлено 2026-08-17, проверено 2026-08-30.
• Agent Skills — Claude Platform Docs — поэтапная загрузка ресурсов в Claude; проверено 2026-08-30.
• Sitemap Marketing OS — проверка отдельного интента; проверено 2026-08-30.

Интервью и три теста — редакционная методика Marketing OS. Это не часть обязательной спецификации Agent Skills.

Продолжить

• Раздел «ИИ без магии» — карта учебного маршрута.
• Предыдущий урок: «Промпт, проект, skill, агент и автоматизация».
• Промпты для маркетинга — как уточнять отдельное задание.
• Обучение команды работе с ИИ — как сделать процедуру общей.
• Следующий урок: «Один skill для разных ИИ-агентов».