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 short, single-purpose skill: lean, fully executable, with an explicit verification step and an error-recovery loop. Its only real defect is navigation — the bundled references/action_primer.md exists but is never referenced from SKILL.md, so the action reference is undiscoverable through the skill's entry point.
Suggestions
Add a one-level-deep reference to the primer, e.g., a line under a '## References' or in When to Use: "For the full action vocabulary, see [action_primer.md](references/action_primer.md)."
Clarify what the primer adds beyond SKILL.md (e.g., measurement actions like `use thermometer on chocolate`) so the reference is clearly signaled rather than merely linked.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~20 lean lines with no padding and no explanation of concepts Claude already knows; every section (When to Use, Procedure, failure note, Example) earns its place, matching 'Lean and efficient; assumes Claude's competence'. It is clearly above anchor 4, which allows minor over-explanation — there is none. | 5 / 5 |
Actionability | Concrete, copy-paste-ready commands are given (`focus on <TARGET_OBJECT>`, `look around`) plus a fully worked example with real values ("63 > 50 is true → target is red box", "Execute: `focus on red box`"), matching 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | The 4-step procedure has an explicit validation step ("Verify: Confirm the focus action succeeded before proceeding") and a feedback loop for error recovery ("If the focus action fails (e.g., object not found), use `look around` to verify the target object name"), matching the anchor 5 example's structure. The operation is not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body itself is well organized, but the bundle contains references/action_primer.md — a relevant action reference — that is never mentioned or linked anywhere in SKILL.md, matching 'Some structure but could be better organized; references present but not clearly signaled'. It is not anchor 4 because an existing bundle file is completely orphaned from the entry point; it is above anchor 2 because the inline content is short, structured, and nothing is improperly inlined. | 3 / 5 |
Total | 18 / 20 Passed |