CtrlK
BlogDocsLog inGet started
Tessl Logo

worker

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

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a model of lean, actionable skill writing: fully executable API commands, a numbered operational sequence with ownership guards, and a well-organized self-contained structure. The only meaningful gap is the absence of explicit error-recovery or validation feedback loops (e.g., what to do when a claim or transition fails).

Suggestions

Add a short error-recovery step, e.g. what to do when claim-task fails because the task is already claimed, or when transition-task-status rejects the claim token.

Specify how to detect and handle stale inbox messages or blocked assignments (when no unblocked task exists) so step 2 has a defined fallback.

Clarify how to obtain and track the claim_token between step 4 and step 6, since only a placeholder is given.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concept explanations, no padding, every line is a concrete command, file path, or protocol constraint, matching the 'every token earns its place' anchor.

5 / 5

Actionability

All five omx team api commands (send-message, claim-task, transition-task-status, mailbox-list, mailbox-mark-delivered) are copy-paste ready with full JSON inputs, plus concrete path-resolution orders and an example ('"1"') for the task-id format.

5 / 5

Workflow Clarity

The 8 steps are clearly sequenced with structured checkpoints (claim before editing, token-gated from/to transitions), but there is no error-recovery or feedback-loop guidance for failures such as a rejected claim or failed transition, so it fits anchor 4 rather than 5.

4 / 5

Progressive Disclosure

At ~43 lines with well-organized sections and no need for separate bundle files, the body is self-contained; the single reference to the AGENTS.md invariant section is clearly signaled and one level deep.

5 / 5

Total

19

/

20

Passed

Description

62%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concise and distinctive, naming a clear niche (tmux-based OMX team workers) with three concrete protocol components. Its main weakness is the absence of any explicit 'Use when...' trigger guidance, and its keywords lean toward project jargon rather than natural user phrasing.

Suggestions

Add an explicit trigger clause, e.g. 'Use when a session is started as an OMX Team worker or when the user mentions team workers, ACKs, or task claims.'

Include natural synonyms or environment markers users would actually say (e.g. 'OMX_TEAM_WORKER', 'team worker', 'leader-fixed') to broaden trigger coverage.

Restate the protocol components as concrete actions (e.g. 'Sends startup ACKs, claims and transitions tasks, checks and acknowledges mailbox messages') for stronger specificity.

DimensionReasoningScore

Specificity

The parenthetical '(ACK, mailbox, task lifecycle)' lists several concrete protocol components, going beyond the 1-2 concrete actions of anchor 3, though they are noun phrases rather than verb-style actions, leaving minor coverage gaps.

4 / 5

Completeness

The 'what' is clear (worker protocol covering ACK, mailbox, task lifecycle), but the description has no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Terms like 'worker', 'team', 'ACK', 'mailbox', 'tmux', and 'OMX' are relevant to the domain but are largely project-specific jargon; common natural variations or synonyms a user might say are missing, matching anchor 3.

3 / 5

Distinctiveness Conflict Risk

'Team worker protocol ... for tmux-based OMX teams' carves out a clear niche with distinct triggers and minimal overlap risk with any generic skill.

5 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Yeachan-Heo/oh-my-codex
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.