Skills

Skill 40 of 67

Rp Subagent Dispatch

How the orchestrator dispatches Developer and QA subagents so a run’s token cost stays bounded: a fresh subagent per round, a short deterministic handoff file, a context budget…

2 minutes · 391 words · 3 sections

Install

$ npx skills add wix/skills --skill rp-subagent-dispatch

$ npx skills add wix/skills

» /plugin marketplace add wix/skills

The first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.

Most of a run’s token cost is history re-sent on every model call, not tool output. A subagent that is resumed round after round keeps re-sending everything it ever saw: one measured run spent 239.5M tokens in a single resumed Developer whose context reached 919K, out of 522M for the whole run. These rules keep each subagent short.

A fresh subagent every round

Every Developer or QA dispatch is a new subagent. Never resume or re-message one from an earlier round — not for QA findings, a crash fix, a retry, or “continue”.
Before each re-dispatch, write the handoff:
```
node skills/wix-replatform/scripts/subagent-handoff.js write --project <dir> \
  --stage <stage> --resource <resources/rp-...> --outcome <outcome> \
  [--findings <QA result file>] [--changed <path,path>] [--notes <one line>]
```
outcome is done, failed, qa_findings, budget_exceeded, needs_decision or resume_limit. It writes state/handoffs/<stage>-<round>.json (≤ 8 KB) from durable state only: the QA findings verbatim, a write-log summary (counts, never rows), the completion report status, open user actions and the paths changed last round. It prints { file, round, bytes, budgetRoundsWithoutProgress }.
The new subagent’s prompt is only: the resource path, the project directory and the handoff file. Paste nothing else — no earlier result text, transcript or log. The subagent reads the handoff first; anything it trimmed is still in its source files.

A context budget per subagent

Each Developer works within about 200K context or 150 model calls, whichever comes first.
Near the budget it stops starting new work, runs subagent-handoff.js write --reason budget_exceeded (with --changed and --notes for where it stopped), and returns budget_exceeded with the handoff path.
budget_exceeded is not a failure and not a QA miss. Dispatch a fresh Developer for the same resource with that handoff.
When the printed budgetRoundsWithoutProgress reaches 3 (three budget rounds in a row with no new settled import progress), tell the operator in one status line that the stage is repeating without progress, add the same note to the next handoff (--notes), and keep going. Never stop the run for it.
Where the host does not report context size, count your own model calls, and keep every tool output under 20 KB by using the bounded helpers below.

Bounded helpers instead of raw files

Never open, cat, grep, tail or jq state/attempts/write-attempts.ndjson or logs/import-audit.ndjson — they reach tens of MB and stay in context for the rest of the subagent’s life. Use:
```
node skills/wix-replatform/scripts/write-log-summary.js --project <dir> \
  [--entity <targetEntityType>] [--status <status>] [--limit 20] \
  [--run latest | --since-run <runId>] [--log audit] [--json]
```
Default output: counts per entity × status (current status per attempt) and top error classes; --entity/--status add up to --limit matching rows. Output stays ≤ 4 KB.
Run a generated import with scripts/import-supervise.js (see rp-execute-import): one tool call that launches, polls, resumes and returns complete, needs_decision or resume_limit, instead of one model call per poll.

About this skill

Trigger

How the orchestrator dispatches Developer and QA subagents so a run's token cost stays bounded: a fresh subagent per round, a short deterministic handoff file, a context budget with a clean handoff, and bounded helpers instead of raw ledgers.

The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.

Colophon for this issue

Colophon

How this issue was made

Source

github.com/wix/skills, branch main, last pushed 8 November 2026.

Licence

MIT — the text of every skill is reproduced unmodified, frontmatter included, under the upstream licence.

Discovery

67 skills found by walking the repository tree for SKILL.md, not by matching a directory convention. 5 distinct layouts observed: skills/*/SKILL.md, skills/wix-headless-replatform/resources/*/SKILL.md, skills/wix-replatform/resources/*/SKILL.md, */SKILL.md, wix-replatform/resources/*/SKILL.md.

Duplicates collapsed

5 mirror copies folded into their canonical skill — republished for Alternate. Copies match on content hash and on position once a leading per-agent prefix is stripped, because the same skill is routinely shipped under a dozen agent directories with a dozen different hashes.

Issue colours

Resolved from a curated brand profile — hue 261°, chroma 0.190. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.

Heading repairs

1 repair applied to this skill so the document has one h1 and no skipped levels:

Removed “rp-subagent-dispatch”, a leading h1 that duplicated the skill title.

Spec compliance

1 editorial note across 1 of 67 skills. They are printed in the margin of each skill rather than as errors here.

Wix Headless Kit — 1 note

Images

Images inside a skill come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.

Marketplace

A plugin manifest is published at .claude-plugin/marketplace.json by Wix, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree.

Signal

Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.

Agent surfaces

The whole issue is available as one markdown document at /wix/skills.md, and each skill at its own .md URL.

Publication

Set by Skills Docs from the source repository. Body text is Literata at the reader’s chosen size and measure; code is Geist Mono. Nothing on this page was written by us except this paragraph.

A fresh subagent every round

Every Developer or QA dispatch is a new subagent. Never resume or re-message one from an earlier round — not for QA findings, a crash fix, a retry, or “continue”.

Before each re-dispatch, write the handoff:

node skills/wix-replatform/scripts/subagent-handoff.js write --project <dir> \
  --stage <stage> --resource <resources/rp-...> --outcome <outcome> \
  [--findings <QA result file>] [--changed <path,path>] [--notes <one line>]

outcome is done, failed, qa_findings, budget_exceeded, needs_decision or resume_limit. It writes state/handoffs/<stage>-<round>.json (≤ 8 KB) from durable state only: the QA findings verbatim, a write-log summary (counts, never rows), the completion report status, open user actions and the paths changed last round. It prints { file, round, bytes, budgetRoundsWithoutProgress }.

The new subagent’s prompt is only: the resource path, the project directory and the handoff file. Paste nothing else — no earlier result text, transcript or log. The subagent reads the handoff first; anything it trimmed is still in its source files.

A context budget per subagent

Each Developer works within about 200K context or 150 model calls, whichever comes first.

Near the budget it stops starting new work, runs subagent-handoff.js write --reason budget_exceeded (with --changed and --notes for where it stopped), and returns budget_exceeded with the handoff path.

budget_exceeded is not a failure and not a QA miss. Dispatch a fresh Developer for the same resource with that handoff.

When the printed budgetRoundsWithoutProgress reaches 3 (three budget rounds in a row with no new settled import progress), tell the operator in one status line that the stage is repeating without progress, add the same note to the next handoff (--notes), and keep going. Never stop the run for it.

Where the host does not report context size, count your own model calls, and keep every tool output under 20 KB by using the bounded helpers below.

Bounded helpers instead of raw files

Never open, cat, grep, tail or jq state/attempts/write-attempts.ndjson or logs/import-audit.ndjson — they reach tens of MB and stay in context for the rest of the subagent’s life. Use:

node skills/wix-replatform/scripts/write-log-summary.js --project <dir> \
  [--entity <targetEntityType>] [--status <status>] [--limit 20] \
  [--run latest | --since-run <runId>] [--log audit] [--json]

Default output: counts per entity × status (current status per attempt) and top error classes; --entity/--status add up to --limit matching rows. Output stays ≤ 4 KB.

Run a generated import with scripts/import-supervise.js (see rp-execute-import): one tool call that launches, polls, resumes and returns complete, needs_decision or resume_limit, instead of one model call per poll.