Agent Dispatch Skill

agent-dispatch is a portable Agent Skill for delegating coding tasks from one agent to another through the Agent Client Protocol (ACP).

It uses acpx as the transport and adds a host-neutral workflow for target selection, permission boundaries, worktree isolation, cancellation, structured handoff, and independent verification.

Compatibility

The host and target are separate roles:

• Host: any agent that can read SKILL.md and execute commands. Codex and OpenCode can discover the skill from .agents/skills/. Other agents can use the same file when their skill loader supports Agent Skills, or when it is supplied as instructions.
• Target: any ACP-compatible agent available through an acpx profile or a trusted custom ACP command. Current profiles include OpenCode, Codex, Grok Build, Claude Code, Gemini CLI, and others.

This supports workflows such as Codex → OpenCode, Grok → OpenCode, Codex → Grok, or OpenCode → Codex. The host product does not need its own ACP client if it can run acpx.

MCP is not used to control the target agent. MCP provides tools and context to an agent; ACP manages agent sessions.

Requirements

• Node.js 22.13 or newer
• acpx installed on the host
• The selected target agent installed and authenticated when required

The examples and command reference are validated with acpx 0.13.1. acpx is pre-1.0, so pin a reviewed version in automation.

npm install --global acpx@0.13.1

Install the skill

Install it at project scope:

mkdir -p .agents/skills
git clone https://github.com/makerjackie/agent-dispatch.git .agents/skills/agent-dispatch

Or install it for the current user:

mkdir -p ~/.agents/skills
git clone https://github.com/makerjackie/agent-dispatch.git ~/.agents/skills/agent-dispatch

OpenCode also supports .opencode/skills/ and its configured skill catalogs. Codex users may place the folder in their configured skills directory. Restart or begin a new agent session after installation if the host caches discovered skills.

Use

Ask the host agent to use agent-dispatch and name the target when it matters:

Use agent-dispatch to ask OpenCode to review this repository without changing files.

Use agent-dispatch to have Grok Build implement the approved plan in an isolated worktree, then verify the diff and tests yourself.

For direct use, read SKILL.md. Detailed commands, safety boundaries, and handoff formats are in references/.

References

• Agent Client Protocol
• ACP agent registry
• acpx
• Codex skills
• OpenCode skills
• Agent Skills specification

Design boundaries

• The skill does not install or authenticate agents without authorization.
• --cwd is not a security sandbox; target-native containment is still required.
• ACP adapter capabilities differ by target and version.
• Interactive terminal scraping is intentionally out of scope.
• Child agents are instructed not to delegate recursively unless the caller explicitly requests a multi-agent workflow.

License

MIT