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.
A highly actionable body with exact file formats, output strings, and error recovery, but it carries noticeable redundancy: instructions and example outputs are repeated across Flow/Instructions/Overview/Examples sections, inflating the token budget without adding information. The behavioural contract also overlaps with the DOCTRINE.md reference it cites.
Suggestions
Collapse 'Flow', 'Instructions', 'Overview', and 'Output' into a single short workflow section — they currently restate the same three-step summary four times.
Keep each subcommand's output block in one place only: either 'Subcommand Details' or 'Examples', not both.
Trim or move the 'Behavioural contract' section to the already-referenced DOCTRINE.md, keeping only a summary plus the routing table, since the file itself says the contract lives there.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core material is precise and free of concept over-explanation, but there is real structural duplication: the same subcommand outputs appear in 'Subcommand Details', again in the 'status' examples, and again in 'Examples', while 'Flow', 'Instructions', 'Overview', and 'Output' each restate the same three-step summary. This is tighter than anchor 2's padded verbosity but well short of 'every token earns its place'. | 3 / 5 |
Actionability | Fully executable guidance: exact file path '.hyperflow/.sticky', exact file format (state/since/trigger), exact one-line output strings per subcommand, and an error-handling table with concrete recovery behavior (backup to '.sticky.bak', create '.hyperflow/' if missing). | 5 / 5 |
Workflow Clarity | The Flow section gives a clear four-step sequence and error handling supplies recovery paths (malformed file → backup + treat as OFF), which is above anchor 3. It is not a 5 because the implicit 'hyperflow-mention upgrade' write happens in 'Activation triggers', detached from the execution flow, slightly blurring what the skill itself does versus what the orchestrator does. | 4 / 5 |
Progressive Disclosure | Good structure with clearly signaled one-level-deep references in the Resources section ('[DOCTRINE.md](../hyperflow/DOCTRINE.md)', '[output-style.md](../hyperflow/output-style.md)') and no nested references. Not a 5 because the ~40-line Behavioural contract duplicates content the file itself attributes to DOCTRINE.md, and much of Subcommand Details/Examples could live in a separate reference. | 4 / 5 |
Total | 16 / 20 Passed |