Content
85%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a lean, highly operational runbook: sequenced steps with explicit completion criteria, concrete CLI examples for the machine-readable API, and a recovery section keyed to specific failure signals. Its only weaknesses are a few steps that reference other cards or name a verification without giving the command, and slightly over-detailed reasoning-effort precedence rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational guidance with no padding or explanation of concepts Claude already knows; every section carries runtime-specific facts. Only the agentReasoning precedence rules ('ultra is unsupported and is not an alias for max', explicit-raw-wins hierarchy) could be tightened, keeping it just below anchor 5. | 4 / 5 |
Actionability | Provides copy-paste-ready commands ('omx team api send-message --input ... --json', 'omx team status <name> --json', 'omx team await ... --timeout-ms 30000 --json') and a concrete launch example. Minor gaps: some steps defer to other cards ('The worker card defines ACK, claim, transition...') and verification steps ('Verify shutdown evidence and state cleanup') name the check without the command. | 4 / 5 |
Workflow Clarity | Operational steps 1-8 form a clear sequence with explicit validation checkpoints (run until 'pending=0, in_progress=0, and failed=0', verify shutdown evidence, 'Do not claim completion while workers are still writing'), plus a dedicated recovery section with feedback loops keyed to concrete error signals ('worker_notify_failed', 'ENOENT') and safety guards on destructive pane/state cleanup. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no bundle files, and is organized into six well-labeled sections. Durable detail is explicitly delegated one level deep ('the durable ownership and safety rules remain in templates/AGENTS.md'; 'Read AGENTS.md#durable-runtime-invariants-canonical-ssot') rather than inlined, matching the simple-skill exception for a top score. | 5 / 5 |
Total | 18 / 20 Passed |