Bundled upstream support

Supporting files are included at skill-relative paths. See UPSTREAM-NOTICE.md for their pinned sources, licenses, hashes, and import changes.

OpenCode Delegate

When to Use

• You want to delegate a bounded coding task to a separate opencode implementer (OpenCode) and then review its diff yourself.
• The user explicitly asked for delegation to this implementer.

You are the orchestrator. This skill lets you hand a bounded coding task to a separate implementer — the OpenCode CLI — then review what it produced and land it yourself. You write the brief and own the judgment; OpenCode does the typing in its own session; you verify and commit.

Nothing here is specific to one orchestrating agent. The loop needs only the ability to run a shell command and read a file, so any agent with those two capabilities — Claude Code, OpenCode driving a sibling session, or a comparable one — can drive it. (It is designed for and run on Claude Code; treat other orchestrators as designed-for, not yet proven.)

When NOT to use this

• The task is small enough to just do inline — delegation overhead is not worth it.
• The opencode CLI is not installed or not authenticated (run opencode auth login).
• You want to write the code yourself, or you only need a review (use the plan agent via --read-only).

Prerequisites (check once)

1. opencode --version succeeds. If not, install (npm i -g opencode-ai, or the native installer from opencode.ai) and opencode auth login.
2. Confirm which opencode is on PATH. command -v opencode shows the active binary and opencode --version its version. The relay records the version it ran into result.json, so a stale binary is visible after the fact.
3. A model provider is authenticated — opencode auth list shows at least one credential.
4. You are in (or will point --cd at) the target git repository.

Choose the implementer model

OpenCode has no safe default — a bare opencode run errors — so a fresh run needs a model via --model or a fleet --lane that sets one (a resumed run inherits its session's model). Naming the model is the one decision a single-model backend like codex-delegate never had, and it has two owners:

• The human owns which models are allowed. opencode models lists hundreds of entries, most billed per token (OpenRouter and the like); only the human knows which are their flat-rate subscriptions, and the CLI can't tell them apart. So the usable set is theirs — ideally stated once in the repo's AGENTS.md or their CLAUDE.md (e.g. "delegate mechanical work to opencode-go/…, hard logic to …").
• You, the orchestrator, pick per task — from that set. Match the model to the brief: a cheap, fast model for a mechanical sweep (rename, migration, removal); a strong one for a subtle bug or a money/security path.
• If no usable set is stated, ask — don't guess. Guessing from the catalog risks a metered model and a surprise bill. Name the constraint to the human and let them choose.

More depth: references/writing-the-brief.md.

The loop

Run these five steps per task. Steps 1, 4, and 5 are your judgment; 2 and 3 are mechanical.

1. Write the brief

OpenCode sees only the text you send plus what it can read from the working tree — no chat history, no shared context. Everything the task needs goes in the brief: the goal, the current state, what to change, what to leave untouched, the project's actual gate commands (discover them from the repo's AGENTS.md/CLAUDE.md/Makefile — do not assume), and a report contract. Tell OpenCode it will not commit (you will). Keep one task per brief. Full guidance and a template: references/writing-the-brief.md.

2. Dispatch

Send the brief to OpenCode with the bundled helper. It wraps opencode run, captures the run, and writes a structured result.json — so your only job is "run a command, read a file." (<skill-dir> below is this skill's installed directory — the folder containing this SKILL.md. Claude Code prints it as "Base directory for this skill" when the skill loads; on other orchestrators use that same directory — if unsure where it landed, run find ~ -name relay.mjs -path '*opencode-delegate*' and substitute the directory above it.)

…