Скиллы для ИИ-агентов

Скиллы GetMyBot — это готовые агентские обёртки над GetMyBot API. Они учат ИИ-агента (например, Claude Code) работать с вашими ботами на естественном языке: «создай реакцию в GetMyBot», «запусти рассылку GetMyBot по метке VIP», «покажи статистику бота». Под капотом скилл вызывает MCP-инструменты GetMyBot, а если MCP-сервер не подключён — делает те же запросы по REST с вашим токеном.

Скиллы — не отдельная платная фича и не маркетплейс. Это файлы SKILL.md (формат Claude Code), которые вы устанавливаете локально рядом со своим агентом.

Как это работает

Каждый скилл устроен по принципу прогрессивного раскрытия: короткое описание триггерит скилл на доменные формулировки, а тяжёлый справочник по API подгружается только когда нужен. Внутри каждого скилла документированы два пути доступа:

  • MCP (предпочтительно) — если MCP-сервер GetMyBot подключён к агенту, скилл вызывает инструменты напрямую.
  • REST-fallback — если MCP недоступен, скилл выполняет те же операции запросами curl с персональным токеном.

Аутентификация во всех скиллах одна: персональный токен mbp_… и базовый адрес /api. Подробнее — в гайде по авторизации.

Шесть скиллов

  • mybot — точка входа и навигация: что такое GetMyBot API, как получить PAT и его области доступа, базовый адрес, как подключить MCP-сервер, когда REST, а когда MCP, формат ошибок, пагинация и лимиты. Отсюда агент попадает в остальные пять скиллов.
  • mybot-bots — подключение и управление ботами: проверка токена, подключение, список и карточка, обновление, синхронизация, смена токена, передача, удаление, настройки, шаблоны.
  • mybot-reactions — конструктор реакций (самый большой): структура «триггер → условия → чаты → действия», создание и обновление, типы триггеров, условия И/ИЛИ, каталог действий, сообщения и кнопки, динамические кнопки и параметры, формулы (DSL), папки, связи реакций, импорт из SamBot, проверка формул, порядок.
  • mybot-broadcasts — рассылки: запуск по реакции, сегментация по меткам, пауза/возобновление/отмена и статус, редактирование уже отправленных сообщений (одиночно и «у всех»), очередь и ретраи.
  • mybot-data — данные и интеграции: коллекции (таблицы — поля и записи), сценарии (flows), интеграции (ИИ, Google Sheets, GetCourse, внешний обработчик по WebSocket), подключения и доступы.
  • mybot-analytics — наблюдаемость и аудитория: статистика (расход баланса, метрики, журнал, здоровье реакций), аналитика (аудитория, чаты, воронки), подписчики и метки, диалоги, биллинг (баланс, тарифы, транзакции).

Установка

Скиллы живут в репозитории GetMyBot в папке skills/. Каждый скилл — это папка skills/<name>/ с файлами SKILL.md (краткий гайд) и reference.md (полный справочник по домену с примерами на MCP и curl).

Чтобы агент увидел скиллы, свяжите их со своим каталогом скиллов Claude Code. В репозитории есть готовый скрипт:

./skills/install.sh

Он создаёт симлинки ~/.claude/skills/<name> на папки внутри репозитория — правки в репозитории сразу видны агенту, лишних копий не плодится. После установки сформулируйте задачу обычными словами («собери в GetMyBot бота-автоответчик»), и агент сам подтянет нужный скилл.

Что дальше