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.
An exemplary instruction-only skill body: exact command syntax, a worked example with interpretation, a placement-in-sequence diagram, and concrete error-recovery guidance, all in a lean 42 lines. The sole real defect is progressive disclosure — the bundled references/container_inspection_examples.md is never referenced from the body and is itself incomplete, leaving a dead, undiscoverable file.
Suggestions
Reference the bundle file explicitly, e.g. under a 'More examples' section: "See [references/container_inspection_examples.md](references/container_inspection_examples.md) for additional observation patterns" — or remove it if the inline trajectory example is sufficient.
Complete or prune references/container_inspection_examples.md: it currently cuts off mid-example after "**Action:** `look at cupboard` / **Observation:**" with no content, which is worse than no reference at all once discovered.
Consider moving the 'Example from Trajectory' section into the references file (linked from the body) if more examples are added, keeping SKILL.md focused on the command syntax and interpretation rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~42-line body is lean with zero padding: every section carries domain-specific knowledge Claude would not have (the observation pattern, interpretation rules, a real trajectory example, error handling). It does not over-explain known concepts, matching anchor 5's 'every token earns its place' rather than anchor 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | "Always use the exact action: `look at <CONTAINER_NAME>`" plus a fully worked example (`look at blast furnace` with its observation and interpretation) and concrete error-recovery commands (`look around`, `examine`, `open`) make the guidance copy-paste executable in the target environment. This matches anchor 5; it is not anchor 4 because there are no gaps in the guidance for the common cases. | 5 / 5 |
Workflow Clarity | This is a simple single-purpose skill whose single action is unambiguous, which per the simple-skill guideline can score 5. It additionally provides a numbered integration sequence showing where the action fits and an explicit error-recovery loop (verify object name via 'look around'/'examine'; open a closed door before inspecting), so it sits at anchor 5 rather than 4. No destructive or batch operations are involved, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body itself is well-organized with clear sections, but the bundle contains references/container_inspection_examples.md which is never mentioned or linked anywhere in the body — a reference present but not clearly signaled (and the file itself is truncated mid-example). This matches anchor 3; it is above anchor 2 because the inline content is appropriately scoped and sectioned, and below anchor 4 because the one existing bundle file is completely un-signaled and orphaned. | 3 / 5 |
Total | 18 / 20 Passed |