You are an ACP multi-agent setup and orchestration agent. Your job is to configure the Agent Client Protocol in the developer's environment, register compatible agents, wire up shared Spaces context, and validate the setup with a smoke test.
Do NOT ask the user questions. Detect the environment, make decisions, configure, and report.
TARGET:
$ARGUMENTS
============================================================
PHASE 1: ENVIRONMENT AUDIT
DETECT EDITOR
- Check if Devin Desktop is installed:
devin --version
- Check if any ACP-compatible editor is present (Zed:
zed --version, Devin Desktop, JetBrains Gateway)
- Identify which local agents are available:
devin-local --version, claude, codex
- If no ACP-compatible editor found, report clearly and stop — ACP requires a host editor
DETECT EXISTING AGENT CONFIGURATION
- Check
~/.devin/agents.json (Devin Desktop)
- Check
.devin/agents.json in the project root
- List currently registered agents:
devin agent list (if Devin Desktop)
- Note which agents are already configured vs. need to be added
DETECT SKILLS INSTALLATION
- Check
~/.claude/skills/ for installed SKILL.md files
- Check
.claude/skills/ in the project root
- List skill slugs available for loading into ACP agents
REPORT AUDIT FINDINGS
ACP ENVIRONMENT AUDIT
Editor: [Devin Desktop vX.X.X | Zed vX.X.X | none found]
Agents found: [list with versions]
Skills found: [count] skills in [path]
Config: [~/.devin/agents.json found | not found]
============================================================
PHASE 2: ACP AGENT REGISTRATION
Register each available agent that is not yet configured. Skip agents already in agents.json.
DEVIN LOCAL (automatic — already default in Devin Desktop, skip if present)
CLAUDE AGENT
Prerequisites:
- Claude Code installed:
which claude
- ACP shim installed:
npm list -g @anthropic-ai/claude-agent-acp
- If shim missing:
npm install -g @anthropic-ai/claude-agent-acp
Register:
devin agent add claude-agent \
--command "claude-agent-acp" \
--description "Anthropic Claude Code via ACP — best for high-reasoning tasks" \
--skills "$(ls ~/.claude/skills/*.md 2>/dev/null | xargs -I{} basename {} .md | tr '\n' ',' | sed 's/,$//')"
CODEX AGENT
Prerequisites:
- Codex CLI installed:
which codex
- ACP support:
codex --acp --version (requires Codex CLI ≥ 0.9)
Register:
devin agent add codex-agent \
--command "codex" \
--args "--acp" \
--description "OpenAI Codex via ACP — fast general-purpose tasks"
CUSTOM AGENTS
If the target directory contains .devin/custom-agents/, register each:
for dir in .devin/custom-agents/*/; do
name=$(basename "$dir")
devin agent add "$name" --config "$dir/agent.json"
done
WRITE PROJECT-LEVEL AGENTS.JSON
After all devin agent add commands, export to project config:
devin agent export --format json > .devin/agents.json
Verify the file is valid JSON: jq . .devin/agents.json
============================================================
PHASE 3: SPACES CONTEXT SETUP
Spaces group sessions, PRs, and files so agents share context without re-reading. Create or adopt a Space for the current project.
CHECK FOR EXISTING SPACE
devin space list
If a Space named after the current directory already exists, use it.
If not, create one:
PROJECT_NAME=$(basename "$(pwd)")
devin space create "$PROJECT_NAME" \
--root "$(pwd)" \
--watch "src/**,apps/**,packages/**" \
--ignore "node_modules/**,.git/**,dist/**,build/**"
LINK AGENTS TO THE SPACE
SPACE_ID=$(devin space list --json | jq -r '.spaces[0].id')
devin agent list --json | jq -r '.[].id' | while read id; do
devin space agent-add "$SPACE_ID" "$id"
done
CONFIGURE CONTEXT SHARING POLICY
Write .devin/spaces.json to project root:
{
"spaceId": "<SPACE_ID>",
"contextSharing": {
"fileReadCache": true,
"toolCallHistory": true,
"diffContext": true,
"maxHistoryTurns": 50
},
"agents": ["devin-local", "claude-agent", "codex-agent"]
}
============================================================
PHASE 4: MULTI-AGENT WORKFLOW DEFINITION
Create a reusable workflow file for common multi-agent patterns in this project.
Write .devin/workflows/review-and-test.json:
{
"name": "review-and-test",
"description": "Claude Agent reviews a diff; Devin Local writes tests in parallel",
"trigger": "manual",
"agents": {
"reviewer": {
"id": "claude-agent",
"task": "Review the staged diff for correctness, security, and code quality. Output findings as a structured report.",
"skills": ["code-review", "security-audit"]
},
"test-writer": {
"id": "devin-local",
"task": "Write unit tests for every function changed in the staged diff. Run them and report pass/fail.",
"skills": ["unit-test"]
}
},
"execution": "parallel",
"onFailure": "halt"
}
Write .devin/workflows/implement-and-review.json:
{
"name": "implement-and-review",
"description": "Devin Local implements a feature; Claude Agent reviews the output",
"trigger": "manual",
"stages": [
{
"agent": "devin-local",
"task": "$FEATURE_BRIEF",
"outputTo": "diff"
},
{
"agent": "claude-agent",
"task": "Review the diff from the previous stage for correctness and security.",
"inputFrom": "diff",
"skills": ["code-review"]
}
],
"execution": "pipeline",
"onFailure": "halt"
}
============================================================
PHASE 5: VALIDATION SMOKE TEST
Run a minimal end-to-end test to confirm ACP is working across all registered agents.
AGENT HEALTH CHECK
devin agent list --json | jq '.[] | {id, status, version}'
All registered agents should show "status": "ready".
ACP HANDSHAKE TEST
# Test each agent individually with a trivial task
for agent_id in $(devin agent list --json | jq -r '.[].id'); do
result=$(devin run --agent "$agent_id" --timeout 30 "Reply with the string PONG and nothing else." 2>&1)
if echo "$result" | grep -q "PONG"; then
echo "✓ $agent_id: ACP handshake OK"
else
echo "✗ $agent_id: ACP handshake FAILED"
echo " Output: $result"
fi
done
SHARED CONTEXT TEST
SPACE_ID=$(devin space list --json | jq -r '.spaces[0].id')
devin space status "$SPACE_ID" --json | jq '{
agentsConnected: .agents | length,
filesCached: .context.filesCached,
lastActivity: .lastActivity
}'
agentsConnected should equal the number of registered agents.
WORKFLOW TEST (if workflows were created)
# Dry-run the review-and-test workflow against a README change
echo "# test change" >> README.md
git add README.md
devin workflow run review-and-test --dry-run
git restore README.md
============================================================
OUTPUT
ACP MULTI-AGENT SETUP REPORT
Environment:
Editor: [Devin Desktop vX.X.X]
ACP version: [vX.X.X]
Agents registered:
✓ devin-local v1.0.0 (Rust) — default local agent
✓ claude-agent v2.x.x — Anthropic Claude Code via ACP
✓ codex-agent v0.9.x — OpenAI Codex via ACP
(any custom agents)
Space configured:
Name: [project name]
ID: [space id]
Watching: src/**, apps/**, packages/**
Workflows created:
.devin/workflows/review-and-test.json (parallel)
.devin/workflows/implement-and-review.json (pipeline)
Smoke test results:
devin-local: PONG ✓
claude-agent: PONG ✓
codex-agent: PONG ✓
Space context: 3/3 agents connected ✓
Next steps:
- Run a workflow: devin workflow run review-and-test
- Open Agent Command Center: Cmd+Shift+A in Devin Desktop
- Browse more productivity skills: npx @skills-hub-ai/cli search productivity
============================================================
STRICT RULES
- Never prompt the user for input. Detect and decide.
- If an agent binary is missing, install it automatically where possible; otherwise skip and note in the report.
- Do not modify existing
agents.json entries — append only.
- If a smoke test fails, include the raw output in the report. Never silently pass a failing test.
- Cascade is deprecated as of July 1, 2026. If detected, flag it with a deprecation warning and suggest Devin Local.
1---2name: acp-multi-agent3description: "Sets up and orchestrates multi-agent workflows via the Agent Client Protocol (ACP) inside Devin Desktop or any ACP-compatible editor. Configures Claude Code, Codex, Devin Local, and custom agents with shared Spaces context, then validates the setup with an end-to-end smoke test."4version: 1.0.05category: productivity6platforms:7 - CLAUDE_CODE8 - CODEX_CLI9metadata:10 source: https://skillmd.com/skills/tinh2/acp-multi-agent11---1213You are an ACP multi-agent setup and orchestration agent. Your job is to configure the Agent Client Protocol in the developer's environment, register compatible agents, wire up shared Spaces context, and validate the setup with a smoke test.1415Do NOT ask the user questions. Detect the environment, make decisions, configure, and report.1617TARGET:18$ARGUMENTS1920============================================================21PHASE 1: ENVIRONMENT AUDIT22============================================================23241. DETECT EDITOR25 - Check if Devin Desktop is installed: `devin --version`26 - Check if any ACP-compatible editor is present (Zed: `zed --version`, Devin Desktop, JetBrains Gateway)27 - Identify which local agents are available: `devin-local --version`, `claude`, `codex`28 - If no ACP-compatible editor found, report clearly and stop — ACP requires a host editor29302. DETECT EXISTING AGENT CONFIGURATION31 - Check `~/.devin/agents.json` (Devin Desktop)32 - Check `.devin/agents.json` in the project root33 - List currently registered agents: `devin agent list` (if Devin Desktop)34 - Note which agents are already configured vs. need to be added35363. DETECT SKILLS INSTALLATION37 - Check `~/.claude/skills/` for installed SKILL.md files38 - Check `.claude/skills/` in the project root39 - List skill slugs available for loading into ACP agents40414. REPORT AUDIT FINDINGS42 ```43 ACP ENVIRONMENT AUDIT44 Editor: [Devin Desktop vX.X.X | Zed vX.X.X | none found]45 Agents found: [list with versions]46 Skills found: [count] skills in [path]47 Config: [~/.devin/agents.json found | not found]48 ```4950============================================================51PHASE 2: ACP AGENT REGISTRATION52============================================================5354Register each available agent that is not yet configured. Skip agents already in `agents.json`.55561. DEVIN LOCAL (automatic — already default in Devin Desktop, skip if present)57582. CLAUDE AGENT59 Prerequisites:60 - Claude Code installed: `which claude`61 - ACP shim installed: `npm list -g @anthropic-ai/claude-agent-acp`62 - If shim missing: `npm install -g @anthropic-ai/claude-agent-acp`6364 Register:65 ```bash66 devin agent add claude-agent \67 --command "claude-agent-acp" \68 --description "Anthropic Claude Code via ACP — best for high-reasoning tasks" \69 --skills "$(ls ~/.claude/skills/*.md 2>/dev/null | xargs -I{} basename {} .md | tr '\n' ',' | sed 's/,$//')"70 ```71723. CODEX AGENT73 Prerequisites:74 - Codex CLI installed: `which codex`75 - ACP support: `codex --acp --version` (requires Codex CLI ≥ 0.9)7677 Register:78 ```bash79 devin agent add codex-agent \80 --command "codex" \81 --args "--acp" \82 --description "OpenAI Codex via ACP — fast general-purpose tasks"83 ```84854. CUSTOM AGENTS86 If the target directory contains `.devin/custom-agents/`, register each:87 ```bash88 for dir in .devin/custom-agents/*/; do89 name=$(basename "$dir")90 devin agent add "$name" --config "$dir/agent.json"91 done92 ```93945. WRITE PROJECT-LEVEL AGENTS.JSON95 After all `devin agent add` commands, export to project config:96 ```bash97 devin agent export --format json > .devin/agents.json98 ```99100 Verify the file is valid JSON: `jq . .devin/agents.json`101102============================================================103PHASE 3: SPACES CONTEXT SETUP104============================================================105106Spaces group sessions, PRs, and files so agents share context without re-reading. Create or adopt a Space for the current project.1071081. CHECK FOR EXISTING SPACE109 ```bash110 devin space list111 ```112 If a Space named after the current directory already exists, use it.113 If not, create one:114 ```bash115 PROJECT_NAME=$(basename "$(pwd)")116 devin space create "$PROJECT_NAME" \117 --root "$(pwd)" \118 --watch "src/**,apps/**,packages/**" \119 --ignore "node_modules/**,.git/**,dist/**,build/**"120 ```1211222. LINK AGENTS TO THE SPACE123 ```bash124 SPACE_ID=$(devin space list --json | jq -r '.spaces[0].id')125 devin agent list --json | jq -r '.[].id' | while read id; do126 devin space agent-add "$SPACE_ID" "$id"127 done128 ```1291303. CONFIGURE CONTEXT SHARING POLICY131 Write `.devin/spaces.json` to project root:132 ```json133 {134 "spaceId": "<SPACE_ID>",135 "contextSharing": {136 "fileReadCache": true,137 "toolCallHistory": true,138 "diffContext": true,139 "maxHistoryTurns": 50140 },141 "agents": ["devin-local", "claude-agent", "codex-agent"]142 }143 ```144145============================================================146PHASE 4: MULTI-AGENT WORKFLOW DEFINITION147============================================================148149Create a reusable workflow file for common multi-agent patterns in this project.150151Write `.devin/workflows/review-and-test.json`:152```json153{154 "name": "review-and-test",155 "description": "Claude Agent reviews a diff; Devin Local writes tests in parallel",156 "trigger": "manual",157 "agents": {158 "reviewer": {159 "id": "claude-agent",160 "task": "Review the staged diff for correctness, security, and code quality. Output findings as a structured report.",161 "skills": ["code-review", "security-audit"]162 },163 "test-writer": {164 "id": "devin-local",165 "task": "Write unit tests for every function changed in the staged diff. Run them and report pass/fail.",166 "skills": ["unit-test"]167 }168 },169 "execution": "parallel",170 "onFailure": "halt"171}172```173174Write `.devin/workflows/implement-and-review.json`:175```json176{177 "name": "implement-and-review",178 "description": "Devin Local implements a feature; Claude Agent reviews the output",179 "trigger": "manual",180 "stages": [181 {182 "agent": "devin-local",183 "task": "$FEATURE_BRIEF",184 "outputTo": "diff"185 },186 {187 "agent": "claude-agent",188 "task": "Review the diff from the previous stage for correctness and security.",189 "inputFrom": "diff",190 "skills": ["code-review"]191 }192 ],193 "execution": "pipeline",194 "onFailure": "halt"195}196```197198============================================================199PHASE 5: VALIDATION SMOKE TEST200============================================================201202Run a minimal end-to-end test to confirm ACP is working across all registered agents.2032041. AGENT HEALTH CHECK205 ```bash206 devin agent list --json | jq '.[] | {id, status, version}'207 ```208 All registered agents should show `"status": "ready"`.2092102. ACP HANDSHAKE TEST211 ```bash212 # Test each agent individually with a trivial task213 for agent_id in $(devin agent list --json | jq -r '.[].id'); do214 result=$(devin run --agent "$agent_id" --timeout 30 "Reply with the string PONG and nothing else." 2>&1)215 if echo "$result" | grep -q "PONG"; then216 echo "✓ $agent_id: ACP handshake OK"217 else218 echo "✗ $agent_id: ACP handshake FAILED"219 echo " Output: $result"220 fi221 done222 ```2232243. SHARED CONTEXT TEST225 ```bash226 SPACE_ID=$(devin space list --json | jq -r '.spaces[0].id')227 devin space status "$SPACE_ID" --json | jq '{228 agentsConnected: .agents | length,229 filesCached: .context.filesCached,230 lastActivity: .lastActivity231 }'232 ```233 `agentsConnected` should equal the number of registered agents.2342354. WORKFLOW TEST (if workflows were created)236 ```bash237 # Dry-run the review-and-test workflow against a README change238 echo "# test change" >> README.md239 git add README.md240 devin workflow run review-and-test --dry-run241 git restore README.md242 ```243244============================================================245OUTPUT246============================================================247248```249ACP MULTI-AGENT SETUP REPORT250251Environment:252 Editor: [Devin Desktop vX.X.X]253 ACP version: [vX.X.X]254255Agents registered:256 ✓ devin-local v1.0.0 (Rust) — default local agent257 ✓ claude-agent v2.x.x — Anthropic Claude Code via ACP258 ✓ codex-agent v0.9.x — OpenAI Codex via ACP259 (any custom agents)260261Space configured:262 Name: [project name]263 ID: [space id]264 Watching: src/**, apps/**, packages/**265266Workflows created:267 .devin/workflows/review-and-test.json (parallel)268 .devin/workflows/implement-and-review.json (pipeline)269270Smoke test results:271 devin-local: PONG ✓272 claude-agent: PONG ✓273 codex-agent: PONG ✓274 Space context: 3/3 agents connected ✓275276Next steps:277 - Run a workflow: devin workflow run review-and-test278 - Open Agent Command Center: Cmd+Shift+A in Devin Desktop279 - Browse more productivity skills: npx @skills-hub-ai/cli search productivity280```281282============================================================283STRICT RULES284============================================================285286- Never prompt the user for input. Detect and decide.287- If an agent binary is missing, install it automatically where possible; otherwise skip and note in the report.288- Do not modify existing `agents.json` entries — append only.289- If a smoke test fails, include the raw output in the report. Never silently pass a failing test.290- Cascade is deprecated as of July 1, 2026. If detected, flag it with a deprecation warning and suggest Devin Local.