acp-router

Route coding-harness requests to ACP harness sessions across supported agents.

4|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/adamhjouj/shieldclaw --skill acp-router-adamhjouj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/adamhjouj/shieldclaw/tree/main/openclaw/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/adamhjouj/shieldclaw --skill acp-router-adamhjouj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route plain-language user requests through the ACP harness routing layer, bypassing subagent runtimes when appropriate to ensure reliable execution in ACP-enabled sessions.

Core Features & Use Cases

  • Intent-driven routing to OpenClaw ACP runtime sessions or direct acpx-driven sessions.
  • Automatic preflight checks and agent-id mapping for ACP harness control.
  • Fallbacks and recovery paths for ACP backend availability issues, including local repair guidance and retry logic.

Quick Start

Use the ACP Harness Router to route a coding-task request through the ACP flow for a thread-based harness session.

Frequently Asked Questions about acp-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I route coding-agent requests to ACP harness sessions?

ACP harness routing directs coding-harness requests to ACP runtime sessions by applying intent-driven routing, bypassing subagent runtimes to ensure reliable execution in ACP-enabled environments.

Does the ACP router support multiple coding agents like Claude and Codex?

ACP routing supports spawning and managing harness threads across multiple agents including pi, claude, codex, opencode, gemini, and kimi through agent-id mapping.

How do I manage thread spawn semantics in an ACP runtime?

Thread spawn semantics are managed automatically by enforcing ACP runtime path usage, controlling how new harness threads are created and directed across supported coding agents.

Why does my ACP harness session fail when the backend is unavailable?

ACP backend availability issues trigger built-in fallback and recovery paths, providing local repair guidance and retry logic to restore session routing without manual intervention.

What is the best way to integrate CLI tools with ACP routing?

CLI integration is handled natively by the ACP router, allowing direct acpx-driven sessions and OpenClaw ACP runtime control through command-line preflight checks.

When do I need ACP routing instead of direct subagent runtimes?

ACP routing is needed when you want to bypass subagent runtimes for reliable execution, utilizing preflight checks and fallback recovery to manage thread-based harness sessions.