worker

Coordinate OMX team worker workflows in tmux sessions with startup ACK and task lifecycle management.

Updated Jul 3, 2025
One-click install
npx skills add https://github.com/andrew-t-james/dotfiles --skill worker-andrew-t-james
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worker
Source: https://github.com/andrew-t-james/dotfiles/tree/main/dot_codex/skills/worker
Command: npx skills add https://github.com/andrew-t-james/dotfiles --skill worker-andrew-t-james

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill defines a standardized protocol for OMX team workers operating in tmux, enabling consistent startup, inbox/mailbox handling, and task lifecycle management.

Core Features & Use Cases

  • Startup acknowledgment: Sends a startup ACK to the lead mailbox before any task work begins.
  • Inbox and task lifecycle: Guides reading inbox files, claiming tasks safely, progressing task statuses, and coordinating with team state.
  • Mailbox & dispatch discipline: Enforces state-first checks and robust interop with the omx CLI for reliable task delivery and rollback when needed.

Quick Start

Initiate a worker session by setting OMX_TEAM_WORKER and follow the startup protocol to acknowledge and begin processing tasks.

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 worker tasks in tmux sessions?

You can coordinate OMX team worker tasks in tmux sessions by using a standardized protocol that handles startup ACKs, mailbox inbox reading, and claim-safe task lifecycle updates via the omx CLI.

What is the startup ACK protocol for OMX team workers?

The startup ACK protocol requires a worker in a tmux pane to send an acknowledgment to the lead mailbox before processing any assigned tasks, ensuring reliable team state synchronization.

How do I manage task lifecycles safely with the omx CLI?

You manage task lifecycles safely with the omx CLI by reading inbox files, claiming tasks safely to prevent conflicts, progressing task statuses, and coordinating updates with the overall team state.

Can I use this worker protocol for OMX teams without tmux?

This worker protocol applies specifically to OMX teams where workers operate in tmux-based panes and rely on mailbox task lifecycles, so it is not designed for non-tmux environments.

Does the worker skill enforce state-first checks for mailbox dispatch?

Yes, the worker skill enforces state-first checks and robust interop with the omx CLI for reliable task delivery, enabling rollback when needed to maintain mailbox dispatch discipline.

What environment variable do I need to set to start an OMX worker session?

To start an OMX worker session, you need to set the OMX_TEAM_WORKER environment variable and follow the startup protocol to acknowledge and begin processing tasks.