Agent skill · ma08
mac-ui-worker
Route bounded UI-only work from a Codex Desktop source task, especially a remote GCP-backed task, to one Mac-local Codex Desktop worker bound to that exact source task. Use when a job needs the Mac task-scoped in-app Browser, native Computer Use, existing Mac UI or login state, direct collaboration with the user for login, MFA, credential entry, clarification, or fresh approval, or a declared source-owned dependency. Also use inside a Mac worker that receives protocol mac-ui-worker/v1. Do not use when a connector, API, or CLI fully handles the task, or when native Desktop transport is unavailable.
What it needs
About 9k tokens when loaded.
What this skill does
Mac UI Worker Route one source task to one reusable Mac-local UI worker. Send the complete job once, keep routine human collaboration in the worker task, and use source callbacks only for declared cross-task boundaries and terminal reporting. Read references/protocol-v1.md completely before sending or accepting a job. It defines the required envelopes, checkpoint authority, dependency flow, correction rules, and receipts. Choose the role Worker: The current task received a valid protocol: mac-ui-worker/v1 request. Requester: The current task needs to arrange Mac UI work. Do not combine the roles in one task. Capability gate Before routing: 1. Confirm the job genuinely requires visible Mac UI or the user explicitly requested one of the supported UI surfaces. Otherwise use a purpose-built connector, API, or CLI when it fully satisfies the request. 2. Require native Codex Desktop project and task tools. The requester needs project discovery, task creation, task reading or waiting, and task messaging. 3. Require exactly one declared top-level surface: iab or computer-use. Split a mixed workflow into successive serial jobs for the same worker. 4. Require the matching worker capability. An iab job needs the in-app Browser tools. A computer-use job needs native Computer Use. 5. Fail closed when transport or the declared surface is unavailable. Codex CLI and Claude Code must not edit app SQLite, JSONL, transcripts, logs, or notification state to fake a Desktop prompt. Never switch surfaces or substitute Chrome, Playwright, generic web access, AppleScript, osascript, JXA, System Events, or synthetic input for the declared surface. Requester workflow 1. Resolve the source binding Treat the exact {sourcehostid, sourcethreadid} pair as the source identity. Read the source task's durable status or task artifact for an existing mac-ui-worker/v1 binding. Resolve saved projects from current metadata. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/mac-ui-worker