Content
75%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 tight, well-sequenced, destructive-operation workflow with concrete commands and solid validation checkpoints. Its main gaps are conceptual mid-process steps lacking exact commands and the absence of an explicit error-recovery retry loop.
Suggestions
Give exact commands for the conceptual steps (e.g. how to "terminalize" Ralph state and "prove" a mode is not linked) so every step is executable.
Add an explicit validate-then-retry feedback loop for cleanup failures rather than only reporting them, to reach the anchor-5 workflow_clarity bar.
Collect the external references (AGENTS.md, docs/contracts/ralph-cancel-contract.md) into a short dedicated references section for clearer navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational guidance with executable commands and no padding of concepts Claude already knows; only minor explanatory clauses like "it is the invariant authority for scope, ownership, hooks, and Team cleanup" could be trimmed, matching anchor 4 rather than the fully lean anchor 5. | 4 / 5 |
Actionability | Concrete executable commands are provided ("omx state list-active --json", "omx state clear --input '{...}' --json", "omx team shutdown <team>"), but steps 3-5 describe behavior conceptually ("terminalize the target state", "Clear standalone modes only after proving...") without exact commands, fitting anchor 4's "minor gaps". | 4 / 5 |
Workflow Clarity | A clearly numbered sequence with explicit validation checkpoints (reject flags before mutation, confirm target before cleanup, prove modes are not linked, confirm post-conditions) is present, so the destructive-cap does not apply; however error handling is "Report rollback or cleanup failures" rather than an explicit re-validate retry loop, matching anchor 4 over anchor 5. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with well-organized sections (When to use, Inputs and preconditions, Operational steps, Exit and evidence) and one-level-deep external references ("AGENTS.md#...", "docs/contracts/ralph-cancel-contract.md"); references are signaled inline rather than in a dedicated navigation section, so it sits at anchor 4 rather than the well-split anchor 5. | 4 / 5 |
Total | 16 / 20 Passed |