🧩 Что это

CustomJS Automation — это навык (skill) для автоматизации операций с платформой CustomJS через Rube MCP (на базе Composio). Он позволяет разработчикам выполнять задачи CustomJS, такие как работа с сущностями, триггерами и пользовательскими скриптами, без ручного вмешательства — через унифицированные MCP-команды.

Навык подходит для разработчиков и SRE-инженеров, которые уже используют Rube MCP в своём клиенте (например, в Cursor, Claude Desktop или любом MCP-совместимом инструменте) и хотят интегрировать CustomJS в автоматизированные сценарии.

⚙️ Как работает

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

🔍 Шаг 1: Поиск инструментов (RUBE_SEARCH_TOOLS)

Перед любым действием нужно узнать актуальные схемы инструментов CustomJS. Это делается вызовом RUBE_SEARCH_TOOLS с указанием конкретного сценария (use case):

RUBE_SEARCH_TOOLS
queries: [{use_case: "Customjs operations", known_fields: ""}]
session: {generate_id: true}

Ответ вернёт список доступных tool_slug, входные схемы (input schemas), рекомендации по выполнению и известные ловушки (pitfalls). Не используй жёстко закодированные имена инструментов — они могут меняться.

🔗 Шаг 2: Проверка соединения (RUBE_MANAGE_CONNECTIONS)

Убедись, что у тебя есть активная сессия с CustomJS:

RUBE_MANAGE_CONNECTIONS
toolkits: ["customjs"]
session_id: "your_session_id"

Если статус не ACTIVE, следуй возвращённой ссылке для авторизации. Не запускай рабочие процессы, пока соединение не станет активным.

🚀 Шаг 3: Выполнение инструментов (RUBE_MULTI_EXECUTE_TOOL)

После того, как ты получил схемы и проверил соединение, можно выполнять нужные инструменты:

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "TOOL_SLUG_FROM_SEARCH",
  arguments: { /* поля из схемы поиска */ }
}]
memory: {}
session_id: "your_session_id"

Важно: Параметр memory обязателен — передавай пустой объект {}, если не нужно сохранять контекст. Повторно используй session_id в пределах одного рабочего процесса; для нового процесса генерируй новый ID.

📦 Дополнительные операции

• Пакетная обработка (Bulk): Используй RUBE_REMOTE_WORKBENCH с вызовом run_composio_tool() для массовых или кастомных сценариев.
• Полная схема: Если скрипту требуется детальная схема с schemaRef, вызови RUBE_GET_TOOL_SCHEMAS.
• Пагинация: Обязательно проверяй ответы на наличие токенов пагинации и продолжай выборку до полного получения данных.

📌 Когда использовать

Этот навык идеально подходит для сценариев, где требуется:

• Автоматизация создания/редактирования сущностей в CustomJS (например, создание email-шаблонов, триггеров или контента).
• Интеграция CustomJS в CI/CD пайплайны — выполнение операций с CustomJS как часть деплоя или тестирования.
• Сложные многошаговые сценарии с несколькими вызовами инструментов, где нужно сохранять сессию и память.
• Быстрое прототипирование в MCP-клиентах (Cursor, Claude Desktop) — навык даёт готовые шаблоны команд, избавляя от ручного копания в API.

⚠️ Важно знать

• Всегда сначала ищи инструменты — схемы могут измениться в любой момент. Жёстко закодированные tool_slug или аргументы приведут к ошибкам.
• Проверь подключение перед каждым воркфлоу — даже если соединение было активно раньше, токен мог истечь.
• Соблюдай типы полей из найденной схемы — ошибка в названии или типе (строка вместо числа) приведёт к падению.
• Параметр memory всегда обязателен в RUBE_MULTI_EXECUTE_TOOL — не забывай его передавать, даже пустым.
• Используй RUBE_REMOTE_WORKBENCH для кастомных Bulk-операций, если стандартных инструментов недостаточно.
• Пагинация: если в ответе есть токен следующей страницы, запрашивай данные до последней записи.

📚 Справочная шпаргалка

Синхронизируйте навыки с Claude Cowork, Claude Code, Codex и другими.

Установка одной командой.

npx skillfish add composiohq/awesome-claude-skills customjs-automation