# cao-supervisor-protocols

> Claude/Codex skill by [@awslabs](https://omgskills.com/library/awslabs/index.md) · 912 stars · Updated 2026-07-18

Supervisor-side orchestration patterns for assign, handoff, and idle inbox delivery in CAO

## Install

```sh
git clone https://github.com/awslabs/cli-agent-orchestrator /tmp/cli-agent-orchestrator && ln -s /tmp/cli-agent-orchestrator/skills/cao-supervisor-protocols ~/.claude/skills/cao-supervisor-protocols
```

## From README

CAO Supervisor Protocols Use this skill when supervising worker agents through CLI Agent Orchestrator. This skill covers how supervisors should dispatch work, decide between assign and handoff, and receive worker results without blocking inbox delivery. Core MCP Tools From cao-mcp-server, supervisors orchestrate work with: assign(agentprofile, message) for asynchronous work that returns immediately handoff(agentprofile, message) for synchronous work that blocks until the worker finishes sendmessage(message, receiverid=None) for direct messages — receiverid defaults to the terminal that created yours via handoff/assign answeruserprompt(terminalid, answer) for answering a Hermes worker that reports waitinguseranswer Your own terminal ID is available in the CAOTERMINALID environment variable. CAO appends it to assigned task messages and records it on worker terminals automatically, so you rarely need to handle it yourself.

## Links

- HTML page: https://omgskills.com/skills/awslabs/cli-agent-orchestrator/cao-supervisor-protocols/
- GitHub: https://github.com/awslabs/cli-agent-orchestrator
- Author: [@awslabs](https://omgskills.com/library/awslabs/index.md)

## More from this repo

- [cao-learning](https://omgskills.com/skills/awslabs/cli-agent-orchestrator/cao-learning/index.md) — Report task outcomes and distill lessons so the team improves across runs — report\_outcome after each unit of work,...
   - [@awslabs](https://omgskills.com/library/awslabs/index.md) · 969 stars
- [mcp-apps-builder](https://omgskills.com/skills/awslabs/cli-agent-orchestrator/mcp-apps-builder/index.md) — Equip the agent with the official Model Context Protocol "MCP Apps" builder Agent Skills (create-mcp-app,...
   - [@awslabs](https://omgskills.com/library/awslabs/index.md) · 927 stars

## More skills by this author

- [aws-lambda-microvms](https://omgskills.com/skills/awslabs/agent-plugins/plugins/aws-serverless/skills/aws-lambda-microvms/index.md) — Build, run, debug, and operate applications on AWS Lambda MicroVMs — Firecracker-isolated, snapshot-resumable...
   - [@awslabs](https://omgskills.com/library/awslabs/index.md) · 927 stars