cao-worker-protocols
FeaturedWorker-side callback and completion rules for assigned and handed-off tasks in CAO
AI & Automation 1,252 stars
263 forks Updated today Apache-2.0
Install
Quality Score: 89/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# CAO Worker Protocols
Use this skill when acting as a worker agent inside CLI Agent Orchestrator.
This skill explains how workers should interpret assigned versus handed-off work, when to call `send_message`, and how to report results back cleanly.
## Understand the Dispatch Mode
Workers receive tasks through one of two orchestration modes:
- `handoff`: blocking work where the orchestrator captures your final output automatically
- `assign`: non-blocking work where you must actively return results to the requesting terminal
Depending on provider and CAO behavior, a handoff may be made explicit in the task text. For example, Codex workers currently receive a `[CAO Handoff]` prefix for blocking handoffs. Other providers may rely on the task wording and orchestration context instead.
## Rules for Handoff Tasks
When the task is a blocking handoff, complete the work and present the result in your normal response. The orchestrator captures that response automatically.
Do not call `send_message` for ordinary handoff completion unless the task explicitly asks for additional side-channel communication.
## Rules for Assigned Tasks
When the task came through `assign`, send your results back after you finish the work:
1. Format the result clearly and concisely.
2. Call `send_message(message=...)` — omitting `receiver_id` routes the result to the terminal that assigned the task (the recorded caller). This is the reliable default.
3. If the task message names a different callb...
Details
- Author
- awslabs
- Repository
- awslabs/cli-agent-orchestrator
- Created
- 1 years ago
- Last Updated
- today
- Language
- Python
- License
- Apache-2.0
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
cao-worker-protocols
Worker-side callback and completion rules for assigned and handed-off tasks in CAO
1 Updated yesterday
IUnknown404I AI & Automation Featured
cao-supervisor-protocols
Supervisor-side orchestration patterns for assign, handoff, and idle inbox delivery in CAO
1,252 Updated today
awslabs AI & Automation Listed
cao-supervisor-protocols
Supervisor-side orchestration patterns for assign, handoff, and idle inbox delivery in CAO
1 Updated yesterday
IUnknown404I