← Back to Skills Marketplace
713
Downloads
0
Stars
4
Active Installs
7
Versions
Install in OpenClaw
/install acpx-orchestrator
Description
Enhanced terminal AI agent orchestrator with parallel execution, health checks, and workflow presets.
README (SKILL.md)
acpx v4.0 - Agent Orchestrator
Enhanced CLI wrapper di atas acpx dengan fitur orchestration: parallel, health check, workflows.
Quick Start
# Discover agents
acpx discover
# Health check
acpx health
# Run single agent
acpx run opencode "Fix bug"
# Run workflow
acpx workflow review
Commands
| Command | Description | Example |
|---|---|---|
discover |
List installed agents | acpx discover |
health |
Test all agents | acpx health |
run |
Run single agent | acpx run opencode "task" |
parallel |
Run agents parallel from file | acpx parallel tasks.txt |
batch |
Run agents sequential from file | acpx batch tasks.txt |
watch |
Watch agent status | acpx watch opencode |
kill |
Kill agent sessions | acpx kill opencode |
workflow |
Run preset workflow | acpx workflow review |
json |
Run with JSON output | acpx json opencode "task" | jq |
exec |
Direct acpx passthrough | acpx exec opencode "task" |
Workflows
| Workflow | Description |
|---|---|
review |
Code review dengan JSON output |
refactor |
Safe refactoring dengan diff |
test |
Generate pytest tests |
debug |
Deep investigation (600s timeout) |
Batch File Format
# tasks.txt
opencode exec 'Fix auth.py'
pi exec 'Create tests'
kimi --print --yolo --prompt 'Review changes'
acpx parallel tasks.txt # Run parallel
acpx batch tasks.txt # Run sequential
Spawn via OpenClaw
// Health check
sessions_spawn(
task="acpx health",
label="health-check",
runtime="subagent",
mode="run"
)
// Run workflow
sessions_spawn(
task="acpx workflow review",
label="review",
runtime="subagent",
mode="run"
)
// Parallel tasks
sessions_spawn(
task="acpx parallel tasks.txt",
label="parallel-jobs",
runtime="subagent",
mode="run"
)
// JSON output
sessions_spawn(
task="acpx json opencode 'List functions'",
label="json-task",
runtime="subagent",
mode="run"
)
Helper Scripts
acpx- Main orchestrator CLIacpx-batch- Legacy sequential runneracpx-workflow- Legacy workflow presetsacpx-discover- Legacy discovery
Changelog
- v4.0.0 - Enhanced orchestrator: parallel, health check, workflows, json output
- v3.1.0 - Simple CLI wrapper
- v3.0.0 - Generic auto-discovery
- v2.0.0 - Async multi-agent patterns
- v1.0.0 - Initial wrapper
Usage Guidance
This skill is an orchestration wrapper and mostly consistent with that purpose, but there are several things to check before installing:
- Confirm the source: manifest.json references a GitHub repo (https://github.com/qriiz112/acpx-orchestrator) while the registry says 'Source: unknown' and 'Homepage: none' — verify the repository and author before trusting binaries.
- Verify the acpx binary/npm package: SKILL.md and manifest expect an 'acpx' CLI (and manifest suggests npm packages). If you plan to install those packages, inspect the npm package and GitHub repo for malicious code or unexpected install scripts.
- Be cautious with optional agents: the manifest lists optional external agents (Anthropic/pi, etc.). Those agents may require service credentials or send data externally. Do not provide secrets to those agents unless you trust them.
- Understand runtime behavior: the skill's examples use sessions_spawn to run subagents. Allowing the agent to spawn subagents means it can execute multiple agent processes and pass arbitrary tasks; limit what you let it run and review tasks it will forward.
- Metadata mismatches: the registry's top-level metadata (no required binaries/homepage) conflicts with files inside the package that declare requirements. Ask the publisher to clarify/correct metadata before installation.
If you cannot verify the package source or are uncomfortable with an orchestrator that spawns other agents, avoid installing or run it in an isolated environment (container/VM) and inspect any installed npm packages and their install scripts first.
Capability Analysis
Package: acpx (xpi)
Version: 4.0.0
Description: Enhanced terminal AI agent orchestrator with parallel execution, health checks, and workflow presets
The provided files consist of metadata (manifest.json, _meta.json) and documentation (README.md, SKILL.md, COMPARISON.md) for a tool named 'acpx', described as an AI agent orchestrator. The package defines a set of CLI commands for managing and running various AI agents like 'opencode' and 'pi'. No executable source code (Python, JavaScript, or shell scripts) is present in the provided files. The configuration and documentation describe standard orchestration logic, such as health checks, parallel execution, and workflow presets, with no evidence of malicious behavior, secret exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
The declared purpose (CLI orchestrator for agents) matches the instructions and manifest: the SKILL.md and manifest.json reference an 'acpx' CLI plus optional agent packages (opencode, @anthropic-ai/pi, kimi, etc.), which is coherent for an orchestrator. However, the registry summary above this bundle claims 'Required binaries: none' and 'Homepage: none' while manifest.json and SKILL.md explicitly list 'acpx' as a required binary and include a GitHub homepage/repository. This metadata mismatch is unexpected and should be confirmed.
Instruction Scope
SKILL.md contains only CLI usage for the acpx tool and examples of sessions_spawn(...) calls to spawn subagents (runtime='subagent', mode='run'). There are no instructions to read arbitrary files or environment variables in the included docs. Spawning subagents and passing tasks/flags is exactly the orchestrator's role, but it does mean the skill will cause execution of other agents/commands whose behavior depends on those agents — potential data forwarding or remote API interaction is possible via those agents.
Install Mechanism
The package is instruction-only (no code files) so the platform will not run installs automatically. However, manifest.json includes an 'install' section referencing npm packages ("acpx" and optional agent packages). This is not enforced by the registry metadata but indicates the author expects an npm-based install. Because there is no direct install spec executed by the platform, immediate install risk is low — nonetheless, if you follow the manifest's suggested npm installs, verify the packages and sources before running.
Credentials
The skill does not request environment variables or credentials in the registry metadata or SKILL.md. That is proportionate for a CLI orchestrator. However the manifest references optional external agent packages (e.g., '@anthropic-ai/pi') that in real use may require service credentials; the SKILL.md's sessions_spawn will pass tasks to subagents and could cause those agents to interact with external APIs. Make sure you do not inadvertently supply credentials to optional agents or allow the orchestrator to forward secrets.
Persistence & Privilege
always:false (no forced always-on) and default model invocation is allowed. The skill instructs spawning subagents (sessions_spawn), which is expected for an orchestrator but expands runtime activity. This is consistent with the stated purpose and does not itself request persistent system-wide privileges or modify other skills.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install acpx-orchestrator - After installation, invoke the skill by name or use
/acpx-orchestrator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v4.0.6
Fixed: CLI agents support (kilo, kimi), added warnings section to SKILL.md, added binaries.warnings to manifest, security notes documented
v4.0.5
Fixed ClawHub metadata: binaries field, install.command, synced manifest.json and SKILL.md frontmatter
v4.0.4
Fixed: Proper install spec declaration, homepage metadata, batch/parallel working directory support, opencode/pi command fix
v4.0.3
Fixed: Added race condition warning to parallel command, clarified parallel vs batch usage in docs
v4.0.2
Fixed manifest structure: requires.bins, suggests.bins, proper install.npm format
v4.0.1
Fixed manifest: added requirements.bins, optional binaries, npm install, and proper metadata
v4.0.0
Enhanced agent orchestrator with parallel execution, health checks, workflows, and JSON output mode. Supports opencode, pi, kimi, kilo, codex, claude.
Metadata
Frequently Asked Questions
What is ACP Orchestrator?
Enhanced terminal AI agent orchestrator with parallel execution, health checks, and workflow presets. It is an AI Agent Skill for Claude Code / OpenClaw, with 713 downloads so far.
How do I install ACP Orchestrator?
Run "/install acpx-orchestrator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ACP Orchestrator free?
Yes, ACP Orchestrator is completely free (open-source). You can download, install and use it at no cost.
Which platforms does ACP Orchestrator support?
ACP Orchestrator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ACP Orchestrator?
It is built and maintained by qriiz112 (@qriiz112); the current version is v4.0.1.
More Skills