worker

Coordinate OMX team task workflows with a tmux-based worker protocol.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill worker-kyrie66nb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worker
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.agents/skills/worker
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill worker-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams using OMX in tmux need a disciplined, repeatable protocol to coordinate workers, acknowledge arrivals, read tasks, claim work, and report results without losing track.

Core Features & Use Cases

  • Startup Protocol (ACK): workers announce readiness to the leader via a fixed acknowledgement flow.
  • Inbox + Tasks: workers parse and claim tasks from a centralized state, ensuring ordered processing.
  • Mailbox & Status Updates: maintain durable communications and status transitions back into the team state store.
  • Shutdown & Recovery: orderly shutdown and state recovery to resume workflows after restarts.

Quick Start

Set OMX_TEAM_WORKER to <team-name>/worker-<n>, then read your inbox and begin the first unblocked task.

Frequently Asked Questions about worker

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

FAQPage Schema
How do I coordinate OMX team tasks in tmux without losing track of work?

Coordinate OMX team tasks in tmux by enforcing a worker protocol with ACK flows, mailbox handling, and task lifecycle management. Workers parse identity, read centralized inbox files, claim unblocked tasks, execute work, and report completion back to a durable state store.

What is the tmux worker ACK protocol for OMX team sessions?

The tmux worker ACK protocol is a fixed startup sequence where OMX workers announce readiness to the team leader. Workers parse the OMX_TEAM_WORKER identity variable, read their inbox, claim ordered tasks, and execute work before reporting status transitions back to the state store.

How do I set up an OMX worker to read inbox and claim tasks?

Set the OMX_TEAM_WORKER environment variable to your team-name/worker-n identity, then read your inbox to find the first unblocked task. Workers parse centralized task files, claim work in ordered processing, and write task completion updates to the durable state store.

Can I recover OMX team task workflows after a tmux session restart?

Yes, OMX team task workflows support orderly shutdown and state recovery to resume after restarts. The protocol uses a durable state store with explicit read/write paths, maintaining mailbox communications and task lifecycle status so workers can recover and continue unblocked tasks.

Does the OMX worker protocol require MCP tooling for task lifecycle management?

The OMX worker protocol provides MCP tooling guidance for task lifecycle management, but the core workflow relies on parsing inbox and task files. Workers use explicit read/write paths to claim tasks, execute work, and write completion status back to the centralized state store.

What's the best way to manage task status transitions for OMX team workers?

Manage task status transitions by having OMX team workers write completion updates and mailbox communications back to a durable state store. The protocol enforces ordered processing, ensuring workers claim unblocked tasks and report status through explicit read/write paths during the task lifecycle.