corezoid-api-connector — скилл для Claude Code: работа с Corezoid API
Скилл corezoid-api-connector для автоматизации операций в Corezoid через публичный API. Помогает создавать процессы, которые вызывают /api/2/json/, работают с узлами, процессами и задачами платформы.
MIT ★ 74 обновлён 2026-10-29
/plugin marketplace add corezoid/corezoid-ai-plugin
/plugin install corezoid@corezoidЧто делает corezoid-api-connector
Скилл специализируется на построении процессов Corezoid, которые обращаются к публичному API. Когда вы говорите агенту «вызови Corezoid API» или упоминаете операцию вроде получения списка узлов, скилл срабатывает и помогает спроектировать API Call ноду с нужными параметрами.
Внутри скилла — готовый паттерн процесса с цепочкой: Start → API Call → Reply Success → Done, обработка ошибок и таймаутов. Скилл генерирует JSON процесса с правильной конфигурацией: api_secret_outer для аутентификации, stringified JSON в поле ops, пустая format. Требует три базовых параметра — api_login, api_secret и workspaceId, плюс параметры конкретной операции.
Перед генерацией кода скилл читает документацию corezoid-api-integration.md и проверяет справку на openapi.corezoid.com, чтобы убедиться в названиях полей ops. После создания процесса — валидация через lint-process, деплой и smoke-тест.
Какие задачи решает
- создать процесс, который запрашивает список узлов из Corezoid
- автоматизировать получение данных о задачах через API
- вызвать операцию API с фильтрацией и пагинацией
- обработать ошибки и таймауты при обращении к API
- настроить аутентификацию через
api_secret_outer
Примеры запросов агенту
- Создай процесс для получения списка узлов с лимитом 50
- Вызови Corezoid API для поиска процесса по id
- Спроектируй API Call ноду для операции
/api/2/json/с фильтрацией
Как установить corezoid-api-connector
1Через маркетплейс плагинов
/plugin marketplace add corezoid/corezoid-ai-plugin/plugin install corezoid@corezoidКоманда ставит плагин corezoid целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-api-connector -a claude-code3Вручную: положить файлы
~/.claude/skills/corezoid-api-connector/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/corezoid-api-connector/
1Через Skills CLI (Vercel)
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-api-connector -a codex2Вручную: положить файлы
.agents/skills/corezoid-api-connector/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-api-connector -a cursor2Вручную: положить файлы
.cursor/skills/corezoid-api-connector/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install corezoid/corezoid-ai-plugin plugins/corezoid/skills/corezoid-api-connector2Вручную: положить файлы
.github/skills/corezoid-api-connector/SKILL.md1Через Skills CLI (Vercel)
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-api-connector -a gemini-cli2Командой платформы
gemini skills install https://github.com/corezoid/corezoid-ai-plugin --path plugins/corezoid/skills/corezoid-api-connectorВручную: положить файлы
.devin/skills/corezoid-api-connector/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о corezoid-api-connector
Как установить corezoid-api-connector в Claude Code?
Выполни /plugin marketplace add corezoid/corezoid-ai-plugin, потом /plugin install corezoid@corezoid. Затем npx skills add corezoid/corezoid-ai-plugin --skill corezoid-api-connector -a claude-code и открой ~/.claude/skills/corezoid-api-connector/SKILL.md.
Что делает corezoid-api-connector?
Помогает агенту спроектировать процесс Corezoid, который обращается к публичному API. Генерирует готовый паттерн с API Call ноду, обработкой ошибок и аутентификацией через api_secret_outer.
Какие параметры нужны для запуска API?
Три обязательных: api_login (ключ API), api_secret (секрет ключа, используется в api_secret_outer) и workspaceId (ID рабочей области). Плюс параметры конкретной операции — например processId или limit для фильтрации.
Исходный текст
SKILL.md · MIT
---
name: corezoid-api-connector
description: >
Corezoid API connector specialist. Use when the user wants to create a process
that calls the Corezoid public API (/api/2/json/), works with Corezoid objects
(nodes, processes, tasks, users) via the API, or needs to automate Corezoid
platform operations. Activate when the user says "call Corezoid API",
"Corezoid API connector", "node list", "api/2/json", "api_secret_outer",
or references openapi.corezoid.com operations.
---
# Corezoid API Connector
You are a specialist in building Corezoid processes that call the **Corezoid public API**.
> **Always read the reference doc before generating any JSON:**
> `${CLAUDE_PLUGIN_ROOT}/docs/process/corezoid-api-integration.md`
---
## Step 1: Identify the Operation
Ask the user:
- Which Corezoid API operation? (e.g. node list, process list, task list)
- What filtering/pagination params are needed? (limit, offset, obj_id, etc.)
- Where should the process be created? (folder path)
Check [openapi.corezoid.com](https://openapi.corezoid.com) for the `ops` fields of the target operation.
---
## Step 2: Create the Empty Process
Call **`create-process`** with:
- `process_name`: descriptive name, e.g. `"Corezoid API - Node List"`
- `folder_path`: target folder (omit for project root)
Check `scheme.nodes` in the created file — do not add a Start node if one already exists.
---
## Step 3: Define Input Parameters
Every Corezoid API connector requires these base params:
| Name | Type | Description |
| ------------- | ------ | ------------------------------------------- |
| `api_login` | string | API key login |
| `api_secret` | string | API key secret (used in `api_secret_outer`) |
| `workspaceId` | string | Workspace (company) ID |
Add operation-specific params (e.g. `processId`, `nodeId`, `limit`, `offset`).
---
## Step 4: Design the Process
### Process flow — no Code Node needed
```
Start → API Call → Reply Success → Done [obj_type:2]
│
(err)└──► Error Escalation [obj_type:3] ──► Error [obj_type:2]
(time)└─► Timeout Escalation [obj_type:3] ──► Timeout [obj_type:2]
```
### API Call node — key fields
```json
{
"type": "api",
"api_secret_outer": "{{api_secret}}",
"method": "POST",
"url": "https://api.corezoid.com/api/2/json/{{api_login}}",
"format": "",
"extra": {
"ops": "[{\"type\":\"<op_type>\",\"obj\":\"<obj>\",\"company_id\":\"{{workspaceId}}\", ...}]"
},
"extra_type": {
"ops": "array"
},
"extra_headers": { "content-type": "application/json; charset=utf-8" },
"send_sys": true,
"rfc_format": true,
"is_migrate": true,
"customize_response": false,
"response": { "body": "{{body}}", "header": "{{header}}" },
"response_type": { "body": "object", "header": "object" },
"version": 2,
"max_threads": 5,
"debug_info": false,
"cert_pem": "",
"err_node_id": "<error_escalation_id>"
}
```
Add a 30-second timeout semaphor to the API Call node.
### Reply Success node
```json
{
"type": "api_rpc_reply",
"mode": "key_value",
"res_data": { "result": "success", "response": "{{ops[0]}}" },
"res_data_type": { "result": "string", "response": "object" },
"throw_exception": false
}
```
### Critical rules
- `api_secret_outer` handles all authentication — **never** use a Code Node to compute SHA1
- `ops` value must be a **stringified JSON string**, type `"array"`
- `format` must be `""` (empty string) — not `"raw"`
- `send_sys: true` is required
- `customize_response: false` — use default `body`/`header` response mapping
---
## Step 5: Validate and Deploy
```
lint-process → fix errors → push-process → run-task (smoke test)
```
---
## Reference
| Resource | Path |
| ---------------- | ---------------------------------------------------------------- |
| Full pattern doc | `${CLAUDE_PLUGIN_ROOT}/docs/process/corezoid-api-integration.md` |
| Sample process | `${CLAUDE_PLUGIN_ROOT}/samples/corezoid-api-node-list.conv.json` |
| API reference | https://openapi.corezoid.com |
© Corezoid · MIT · corezoid/corezoid-ai-plugin