Content
92%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 an exemplary lean, fully executable protocol with clear sequencing, checkpoints, and a retry loop. Its one real weakness is navigation: the useful references/state_transitions.md bundle file is orphaned — never referenced from the body — so Claude would never discover the state-transition tables when interpreting `examine` output.
Suggestions
Link the bundle reference where it matters, e.g., in step 3: 'Compare the observed state to the previous state (see [state_transitions.md](references/state_transitions.md) for common transition patterns and how to detect adjective/noun changes)'.
Add a brief stopping condition to the wait loop (e.g., how many rechecks before reconsidering, such as verifying the apparatus is still active), so the loop cannot run unbounded.
In the Example, show one intermediate observation from the optional transition states (e.g., 'softening chocolate') so the comparison step demonstrates partial-progress detection.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and instructional throughout — concrete commands, terse conditionals, and a compact worked example with no padding and no explanation of concepts Claude already knows. It matches 'every token earns its place'; there is nothing to trim without losing guidance. | 5 / 5 |
Actionability | Fully executable guidance: exact commands (`look at <APPARATUS>`, `examine <SUBSTANCE>`, `activate <APPARATUS>`, `wait`) with decision branches for both failure modes, plus a complete worked example including realistic observation strings ('a stove (activated), containing: chocolate' → 'liquid chocolate'). This matches the copy-paste-ready, common-cases-covered anchor. | 5 / 5 |
Workflow Clarity | The procedure is a clearly sequenced loop with explicit checkpoints (verify apparatus is active, verify substance present, compare observed state to previous) and a feedback loop for the no-change case ('If no change, use `wait` then repeat from step 1'), with recovery steps for inactive apparatus or missing substance. The skill is read-only observation, so the destructive/batch validation cap does not apply; this fits the anchor with explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | The body itself is well organized into 'When to Use', 'Procedure', and 'Example', but the bundle contains references/state_transitions.md (state-transition tables and observation patterns directly relevant to step 3's state comparison) that is never linked or signaled anywhere in the body. Per the guideline to score against the actual bundle structure, this is 'references present but not clearly signaled' (anchor 3), not the well-signaled one-level-deep structure of anchor 4/5. | 3 / 5 |
Total | 18 / 20 Passed |