# Worker

Team worker protocol (ACK, mailbox, task lifecycle) for tmux-based OMX teams

- Repository: https://github.com/Yeachan-Heo/oh-my-codex (33693 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Yeachan-Heo/oh-my-codex --skill worker -g -a claude-code -y`
Codex: `npx skills add Yeachan-Heo/oh-my-codex --skill worker -g -a codex -y`
Cursor: `npx skills add Yeachan-Heo/oh-my-codex --skill worker -g -a cursor -y`
Gemini CLI: `npx skills add Yeachan-Heo/oh-my-codex --skill worker -g -a gemini-cli -y`

## Description

Team worker protocol (ACK, mailbox, task lifecycle) for tmux-based OMX teams

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Worker Skill

## When to use

Use only when the session was started as an OMX Team worker. Read `AGENTS.md#durable-runtime-invariants-canonical-ssot` before acting; it defines the durable ownership and coordination boundaries.

## Inputs and preconditions

- Require `OMX_TEAM_WORKER=<team-name>/worker-<n>`.
- Resolve this skill from the first existing path:
  `${CODEX_HOME:-~/.codex}/skills/worker/SKILL.md`, `~/.codex/skills/worker/SKILL.md`, `<leader_cwd>/.codex/skills/worker/SKILL.md`, then `<leader_cwd>/skills/worker/SKILL.md`.
- Resolve the Team state root in this order: `OMX_TEAM_STATE_ROOT`, worker identity `team_state_root`, config/manifest `team_state_root`, local `.omx/state`.

## Operational steps

The rest: https://github.com/Yeachan-Heo/oh-my-codex/blob/HEAD/plugins/oh-my-codex/skills/worker/SKILL.md