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.
A lean, highly actionable skill body with an unambiguous workflow and a complete worked example — everything inline earns its tokens. The single notable gap is navigation: the bundled references/action_primer.md, which lists the actions needed for the workflow's final planning step, is never referenced from SKILL.md, leaving a relevant one-level-deep reference undiscoverable.
Suggestions
In the 'Plan Next Actions' step, add a pointer to the bundled reference, e.g. "Common companion actions (mix, pour, focus on, teleport) are listed in references/action_primer.md" — this converts the unsignaled reference into a well-signaled one-level-deep link.
Optionally mention the action primer in the Example's final step ('Proceed to fetch sodium chloride, water, and glass jar, then mix') so the reader knows where to find the exact action syntax before executing.
If the primer is intentionally out of scope for this skill, remove it from the bundle or retitle it so the skill body and bundle structure stay consistent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~28-line body is lean with no padding and no explanation of concepts Claude already knows — every section (Purpose, When to Use, Core Workflow, Example) earns its place. Anti-drift check: not a 4, since there is no over-explanation to trim; the brief Purpose line and the e.g.-clauses ('mixing chemicals, assembling components') each carry information. | 5 / 5 |
Actionability | Fully concrete and executable for this environment: the exact command syntax "`read OBJ`" is given, and the worked example shows real commands ("`pick up recipe`", "`read recipe in inventory`") with expected output ('To make salt water, mix sodium chloride and water in a glass jar.') and the extracted goal/components/procedure. Specific examples cover the common case, matching the top anchor. | 5 / 5 |
Workflow Clarity | The three-step sequence (read the document → extract goal/components/procedure → plan next actions) is clear and unambiguous, and the example walks the full flow end-to-end. This is a simple, non-destructive, non-batch skill so the simple-skill exception applies; it is not a 4 because the single workflow has no meaningful validation gap for a read-only extraction task. | 5 / 5 |
Progressive Disclosure | The body itself is well organized into short sections, but the bundle contains references/action_primer.md — a file of common companion actions explicitly written 'to be used in conjunction with the scienceworld-instruction-reader skill' — and the body never mentions or links it, even though step 3 ('determine which skills and actions to invoke next') is exactly where those actions live. This matches the anchor 'references present but not clearly signaled'. Not a 2 because the inline content is appropriate in size and well-sectioned with no nesting; not a 4 because a provided reference is completely unsignaled from the body. | 3 / 5 |
Total | 18 / 20 Passed |