К основному содержанию
скилл CX Codex

corezoid-edit — скилл для Claude Code: редактирование и установка

Скилл corezoid-edit меняет существующие процессы Corezoid через MCP-сервер: добавляет узлы, исправляет логику и обновляет вызовы API.

MIT ★ 74 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add corezoid/corezoid-ai-plugin
/plugin install corezoid@corezoid
Открыть на GitHub

Что делает corezoid-edit

corezoid-edit помогает редактировать уже созданный процесс Corezoid, а не собирать схему заново. Скилл сначала определяет процесс по пути к файлу, имени или ID, затем открывает локальный .conv.json и анализирует его структуру. Если идентификатор не задан, MCP-инструменты не вызываются.

Изменения вносятся точечно: сохраняются существующие координаты узлов, связи проходят через поле go, а для новых узлов используются серверные ID после pull-process. Константы вроде URL и токенов скилл выносит в переменные через cz-variables и подставляет как {{env_var[@variable-name]}}. Ошибки направляются в Final Error node, если для маршрута не нужна отдельная логика.

Перед правкой нужен локальный файл процесса и доступ к MCP-серверу corezoid. Скилл также обновляет корневое поле description после изменения поведения процесса. Для работы в Codex предусмотрен отдельный способ установки.

Какие задачи решает

  • найти локальный файл процесса по имени или ID
  • изменить логику существующего процесса Corezoid
  • добавить или удалить узел без пересборки схемы
  • подключить API-вызов к процессу
  • исправить маршрут обработки ошибок

Примеры запросов агенту

  • Измени процесс 123_payment.conv.json: добавь API-вызов и сохрани существующие узлы.
  • Найди процесс по имени Payment Flow и исправь ошибку в маршруте после узла оплаты.
  • Обнови логику процесса с ID 1234567890abcdef12345678, вынеся URL в переменную Corezoid.

Как установить corezoid-edit

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-edit -a claude-code

3Вручную: положить файлы

~/.claude/skills/corezoid-edit/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/corezoid-edit/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о corezoid-edit

Как установить corezoid-edit в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add corezoid/corezoid-ai-plugin, затем установите скилл командой /plugin install corezoid@corezoid.

Что делает скилл corezoid-edit?

Он анализирует локальный файл существующего процесса Corezoid и вносит точечные изменения: меняет узлы, связи, поведение и API-вызовы через MCP-сервер corezoid.

Что нужно указать перед редактированием процесса?

Нужен путь к файлу .conv.json, имя процесса или его ID. Без идентификатора скилл сначала запросит его и не будет обращаться к MCP-инструментам.

Исходный текст

SKILL.md · MIT
---
name: corezoid-edit
description: >
  Corezoid process editing specialist. Use when the user wants to modify, update,
  or fix an existing Corezoid process, add or remove nodes, change node behavior,
  add an API call, fix an error, or update process logic. Activate when the user
  says "edit a process", "modify", "update", "fix", "add a node", "change
  behavior", "add a call", "remove a node", or "update the logic".
---

# Edit an Existing Corezoid Process

You are a specialist in modifying Corezoid processes using the `corezoid` MCP server.

## Identify the Process (MANDATORY FIRST STEP)

**Before doing anything else**, resolve `PROCESS_PATH`:

1. Check whether the user already provided a process identifier — a file path, process name, or process ID — in the current message or conversation history.
2. If no identifier is provided, ask:

   > "Please specify the process — you can provide a file path (e.g. `123_payment.conv.json`), a process name, or a process ID."

   Do **not** call any MCP tools until the user provides an identifier.
3. If the user gave a **name or ID** (not a file path), search the local working directory for the matching `.conv.json` file using the `find` or `grep` Bash tools (the project is already pulled locally).
4. Once `PROCESS_PATH` is known and the file exists locally, open and analyze it before making any changes.

---

## Step 1: Analyze the Process

Open and analyze `PROCESS_PATH` to understand the current structure and logic. Pay attention to:

- Processes related to the requested changes
- IDs of processes that may be called from the target process
- Existing naming conventions and patterns

---

## Step 2: Implement the Changes

Apply changes to `PROCESS_PATH`.

### Core rules

- Connect nodes only through the `go` field
- Every node that can fail must have `err_node_id` — point it **directly at a Final Error node** (`obj_type: 2`) unless the error path needs logic (reply to caller, retry routing). Never create an Escalation node (`obj_type: 3`) that only contains a bare `go` — that is a passthrough anti-pattern flagged by `lint-process`
- Node IDs must be unique 24-character hex strings: `^[0-9a-f]{24}$`. **Always `pull-process` before editing** and reference only canonical, server-assigned IDs — IDs you invented in a previous push were reassigned by the server and no longer exist. New nodes added now get placeholder IDs that the server will likewise reassign on push. Existing nodes' IDs are preserved. See [Node ID Lifecycle](${CLAUDE_PLUGIN_ROOT}/docs/process/process-development-guide.md#node-id-lifecycle-server-assignment--stability-on-push).
- Use descriptive node `title` values (e.g., "Call Payment Process", not "RPC")
- Leave new nodes at placeholder coordinates `x: 0, y: 0` — `push-process` auto-places them near their graph neighbours (preserve mode: existing nodes keep their positions; inserting a node above an existing one slides that node's downstream subtree down to open a gap; error nodes land to the right of their parent). **Keep the `x`/`y` of nodes you are NOT moving** — do not rebuild the scheme without them. As a safety net, if the file reaches push with every node's coordinates missing, push re-hydrates them from the server (reports `Restored N node coordinate(s)`) so a laid-out process is never re-arranged by accident. Only when auto-placement is disabled (`COREZOID_AUTOLAYOUT=off`) position nodes manually — error nodes to the right of their parent (`x + 300`). Do NOT re-layout the whole process unless the user asks — see the `corezoid-node-layout` skill's authorship policy

### Variables for constants

All constants (URLs, tokens, endpoints, hosts) must be stored as variables — never hardcoded:

1. Check `_ENV_VARS_.json` (from `pull-folder`) or `.processes/variables.json` (from this session) for existing variables
2. Create a new variable if needed: call **`cz-variables`** with `action: "create-variable"` and `args` `name`, `description`, `value`
3. Reference in logic using `{{env_var[@variable-name]}}`

See `${CLAUDE_PLUGIN_ROOT}/docs/variables-guide.md` for details.

### Node type quick reference

| Node | obj_type | Logic type |
|------|----------|------------|
| Start | 1 | `go` |
| Code Node | 0 | `api_code` |
| Call a Process | 0 (`4` only for active Stub Mode) | `api_rpc` |
| API Call | 0 | `api` |
| Reply to Process | 0 (3 as `err_node_id` target) | `api_rpc_reply` |
| End / Error | 2 | _(no logics)_ |

For complete JSON structures see `${CLAUDE_PLUGIN_ROOT}/docs/node-structures.md`.

### Common pitfalls

- **Regenerating the whole scheme instead of editing it in place** — make targeted edits to the pulled file (change the one node/logic you need). Do NOT rewrite every node from scratch: that drops the existing `x`/`y` (the `x:0,y:0` authoring habit is for *brand-new* nodes only), and a scheme where every node is at `0,0` forces `push-process` to re-lay-out the entire process, discarding its arrangement. push re-hydrates coordinates from the server as a safety net, but editing surgically is the right habit.
- Using `"type": "call_process"` instead of `"type": "api_rpc"` — will fail validation
- Missing `extra`/`extra_type` in Call a Process node — both required even if empty (`{}`)
- Treat active Stub Mode (`obj_type: 4` + `condition.stub`) as a temporary mock only: it bypasses the called process and can fake success. Preserve `condition.stub` during round trips, but do not leave `obj_type: 4` enabled on production paths unless the user explicitly confirms `allow_active_stub_mode=true`.
- Raw JSON objects as values in `extra` — must be stringified: `"{\"key\":\"val\"}"`
- Keys in `extra` and `extra_type` must match exactly

---

## Step 3: Update the Description

Before deploying, update the root-level `description` field in `PROCESS_PATH` to reflect the process's current behaviour after your edits.

**Guard — preserve existing descriptions when appropriate:** if the process already has a non-empty description and your edits did not change the overall purpose (e.g. you fixed a bug, adjusted a timeout, or rewired an error path without altering what the process fundamentally does), preserve the existing description rather than replacing it.

Follow the **Description Update Rule** from the `corezoid` skill:
- 1–2 sentences, starting with a verb (*Calls*, *Creates*, *Validates*, *Routes*, *Aggregates*)
- Sentence 1: what the process does — verb + action + subject
- Sentence 2 (optional): key inputs/outputs or notable behaviour
- Under 200 characters, no *"This process…"* preamble

Write the updated `description` directly into the JSON file. This costs nothing extra — the description rides the same `push-process` call.

If the parent folder was structurally affected (process added, removed, or renamed), also call **`cz-structure`** with `action: "modify-folder"` and a one-sentence `description` in `args`.

---

## Step 4: Deploy the Changes

**MANDATORY: Always run this step whenever any changes were made to the process file — even if there are open questions or the work is not fully complete. Without deploying, all changes are lost.**

Deploy the modified process by calling MCP tool **`push-process`** with `process_path: "<PROCESS_PATH>"`.

If deployment fails, fix the reported errors and re-run `push-process` until it succeeds. Do not skip this step or postpone it — changes exist only in memory until pushed.

> **Auto-snapshot:** if the process already existed on the server (`obj_id` ≠ null), `push-process` automatically creates a snapshot of the current server state before deploying your changes. No action needed — this is transparent. The snapshot appears in the Corezoid UI and can be managed with the `cz-snapshots` actions `list-snapshots` / `get-snapshot` / `delete-snapshot`. Environments whose API has no snapshot object (some on-prem / older installations) are detected by a read-only probe, confirmed against control requests and re-checked periodically per project/stage: the snapshot is skipped, the push proceeds, and the push result says so — keep the `.conv.json` under version control there, because the platform holds no rollback point.

> **Concurrent-change detection & 3-way merge:** `pull-process`/`pull-folder` capture the server version **before** export in a per-folder `.corezoid-baseline.json` sidecar, plus a copy of the pulled process under `.corezoid-baseline/` (add both to `.gitignore`). If someone else changed the process between pull and push, `push-process` **blocks** — a plain push could silently drop their edits — and reports local/server/overlap changes across nodes and process-level fields such as `title`, `description`, `params`, and `scheme.web_settings`. Reconcile one of three ways: re-pull and re-apply; `merge=true` to save the original as `<process>.pre-merge` and graft non-overlapping server changes into the local file for review; or `overwrite_server_change=true` to overwrite after being shown the report (a server snapshot is attempted first, and recovery is possible only if it succeeds). `force=true` is the **lint** override only and does not waive this gate — pass `overwrite_server_change` in reply to the block report, never ahead of it, because set in advance it authorises dropping a change that has not happened yet and that nobody will see. Overwriting live server state that was never compared (`overwrite_server_change`, or `adopt_existing` on a file with no baseline) while no pre-push snapshot could be taken is refused outright unless `allow_no_snapshot=true` is passed as well: neither reported nor recoverable is not a state a single flag should reach. A never-deployed process is exempt — there is no previous version to protect, so the create → push flow never needs the second flag. Every waived gate is named in the push result. Files with no baseline push with an advisory; an unreadable/corrupt baseline blocks until a re-pull rebuilds it, because silently ignoring it would disable lost-update protection. A pre-v3.1.3 sidecar with no recorded merge ancestor cannot run the same-second content check: the push proceeds, says so, and records the ancestor from the live server scheme, so only that one push is unchecked.

After a successful deploy, notify the user:

> "Changes have been deployed. Please **refresh the page** in Corezoid to see the updated process."

---

## Reference Documents

Use the `Read` tool to load these files when specific node or validation details are needed:

| Path | When to read |
|---|---|
| `${CLAUDE_PLUGIN_ROOT}/docs/node-structures.md` | JSON schemas for all node types + full Logics fields reference (canonical) |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/set-parameters-built-in-functions.md` | Built-in functions: `$.math`, `$.date`, `$.random`, `$.sha1_hex`, `$.md5_hex`, `$.base64_encode`, `$.unixtime`, `$.map`, `$.filter` |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/set-parameters-dynamic-values.md` | Dynamic values: `{{var}}`, `{{node[id].count}}`, `{{node[id].SumID}}`, `{{conv[@alias].ref[...]}}`, `{{env_var[@name].key[1]}}` |
| `${CLAUDE_PLUGIN_ROOT}/docs/tasks/task-metadata.md` | Global `root.*` fields: `root.task_id`, `root.ref`, `root.conv_id`, `root.node_id`, `root.prev_node_id`, `root.user_id`, `root.change_time`, `root.create_time` |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/code-node.md` | Code node details and available JS libraries |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/call-process-node.md` | Call a Process node, semaphores, cross-folder calls |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/reply-to-process-node.md` | Reply formats, object stringification |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/api-call-node.md` | HTTP API call configuration |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/end-node.md` | End node success/error configuration |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/condition-node.md` | Condition node (branching logic) |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/delay-node.md` | Delay node (timers and waiting); 30s limit is static-literal only — dynamic absolute-timestamp `value` for scheduled or sub-30s delays |
| `${CLAUDE_PLUGIN_ROOT}/docs/nodes/copy-task-node.md` | Copy Task node (task duplication) |
| `${CLAUDE_PLUGIN_ROOT}/docs/process/process-json-validation.md` | Validation rules and common errors |
| `${CLAUDE_PLUGIN_ROOT}/docs/process/error-handling.md` | Error handling patterns (hardware vs software errors) |
| `${CLAUDE_PLUGIN_ROOT}/docs/process/node-positioning-best-practices.md` | Coordinate system and layout guidelines |
| `${CLAUDE_PLUGIN_ROOT}/docs/variables-guide.md` | Variable naming rules, creation workflow, usage examples |

## Example Processes

| Path | Description |
|---|---|
| `${CLAUDE_PLUGIN_ROOT}/samples/stripe-checkout.json` | Stripe payment checkout flow |
| `${CLAUDE_PLUGIN_ROOT}/samples/create-actors.json` | Creating actors/users |
| `${CLAUDE_PLUGIN_ROOT}/samples/create-user.json` | User creation process |
| `${CLAUDE_PLUGIN_ROOT}/samples/gpt-calculator.json` | GPT integration example |
| `${CLAUDE_PLUGIN_ROOT}/samples/api-post.json` | HTTP POST API call example |

---

## Final Step: Update Git Context

> **Do NOT report the task as complete and do NOT stop until this step is evaluated.**
> The main task being deployed does not mean the session is over — this step is next.

Immediately after `push-process` or `create-process` succeeds, check whether
**at least one** of the following is true:

- `push-process` or `create-process` was actually called (not just previewed);
- a new external host/API/service appeared that is not yet in `dependencies.md`;
- an architectural decision was made (one approach chosen over another);
- an issue was found or closed during this session.

**If yes → activate `corezoid-git-context` skill right now.** Do not wait for the
user to ask. Do not skip because the main task "looks done".

**If none of the above → skip** and tell the user the session is complete.

The skill handles everything autonomously: reads current `_ext/docs/`, proposes
a unified diff, asks confirmation, writes files, and pushes — one invocation.

© Corezoid · MIT · corezoid/corezoid-ai-plugin

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
gpt-image-edit prime-skills Скилл gpt-image-edit редактирует изображения через GPT Image 2 (/edit endpoint ChatGPT Images 2.0) на RunComfy. Сохраняет лица и объекты, переписывает текст на любых языках (кириллица, иероглифы, арабская вязь), принимает до 10 референсов. CX Codex +1 447 000установок yt-edit Jakeschincariol Скилл yt-edit для Claude Code, который превращает транскрипт видео в список решений для монтажа. Генерирует таймкоды для удаления пауз, слов-паразитов и повторов. CX Codex +1 1 300установок capcut-edit renezander030 Скилл capcut-edit для Claude Code редактирует проекты CapCut и JianYing: меняет субтитры, тайминг и скорость, добавляет анимации и нарезает длинные видео на короткие. Подключается к запросам о монтаже, субтитрах или файлах проекта. CX Codex +1 1 300установок anycap-gemini-omni-video-edit anycap-ai Скилл anycap-gemini-omni-video-edit для правки коротких видео через Gemini Omni Flash Preview и AnyCap: меняет один элемент, остальное сохраняет. CX Codex +1 517установок podcast-edit OpenClaudia Скилл podcast-edit автоматизирует монтаж подкастов: находит границы выпуска, удаляет слова-паразиты и длинные паузы через Whisper, а затем выравнивает звук фильтрами FFmpeg. CX Codex +1 291установок genpage-edit-planner Microsoft Субагент genpage-edit-planner для редактирования уже созданных обобщающих страниц в Power Apps. Анализирует текущую реализацию, сравнивает её с вашим запросом и предлагает план изменений — оркестратор согласует его с вами перед применением. CX Codex ★ 1 167звёзд репо

Из того же набора30

Весь набор →
corezoid-state-diagram-create Скилл corezoid-state-diagram-create создаёт стейт-машины Corezoid с типом conv_type: state, структурирует переходы между состояниями и формирует корректный JSON диаграммы. CX Codex +1 ★ 74звёзд репо corezoid-process-optimizer Скилл corezoid-process-optimizer анализирует JSON-процессы Corezoid и предлагает или применяет оптимизации: от объединения узлов до очистки данных и заполнения заголовков. CX Codex +1 ★ 74звёзд репо corezoid-connector-create Скилл corezoid-connector-create генерирует Corezoid-процесс, который вызывает один конкретный endpoint внешнего API (Stripe, OpenWeather, банки, CRM) или своего сервиса. CX Codex +1 ★ 74звёзд репо corezoid-gitcall Скилл corezoid-gitcall помогает запускать произвольный код на 9 языках или в Docker внутри процессов Corezoid, когда стандартных узлов платформы не хватает. CX Codex +1 ★ 74звёзд репо corezoid-alias-manager Скилл corezoid-alias-manager управляет alias процессов в Corezoid: создаёт, список, переименовывает, удаляет и связывает их. CX Codex +1 ★ 74звёзд репо corezoid-variable-manager Скилл corezoid-variable-manager управляет переменными окружения Corezoid на уровне стейджа через инструмент cz-variables и защищает от случайного удаления рабочих ключей. CX Codex +1 ★ 74звёзд репо marketplace-publish-validation Скилл marketplace-publish-validation проверяет готовность проекта Corezoid к публикации: метаданные, процессы и зависимости. Подходит для предпродажной проверки. CX Codex +1 ★ 74звёзд репо corezoid-create Скилл corezoid-create для проектирования и создания процессов Corezoid с нуля. Помогает собрать многошаговый workflow: от сбора требований до генерации JSON-схемы с нодами, обработкой ошибок и тестированием. CX Codex +1 ★ 74звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой