Content
22%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 a minimal placeholder: a meaningless header and the sentence "Use the tool.". While it wastes almost no tokens, it provides no actionable guidance, no workflow, and no meaningful organization — it fails as instruction despite being terse.
Suggestions
Replace "Use the tool." with concrete, executable guidance: name the specific tool/command and show a copy-paste-ready example covering the common case.
Give the body a purposeful structure — replace the placeholder "# Body" header with section titles that reflect the skill's actual task (e.g. a quick-start section), which would also raise progressive disclosure.
If the skill involves any multi-step or risky operation, add an explicit step sequence with a validation checkpoint; otherwise state the single action unambiguously so the simple-skill exception can apply.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is only three lines with no padding or explanations of known concepts, but the single sentence "Use the tool." is vacuous — it conveys nothing, so its tokens do not earn their place. This sits between lean/efficient (4-5) and padded (2); anchor 3 ("mostly efficient but includes some unnecessary explanation") is the closest fit. | 3 / 5 |
Actionability | "Use the tool." is entirely vague: no concrete code, no commands, no named tool, and no described steps — it gestures rather than instructs. It matches anchor 1 ("Entirely vague or abstract; no concrete code or commands") and not anchor 2, which requires at least high-level hints toward specific steps. | 1 / 5 |
Workflow Clarity | No sequence of steps exists at all — just one ambiguous imperative referring to an unspecified "tool". The simple-skill exception (score 5 for a single unambiguous action) does not apply because the action is ambiguous; anchor 1 ("Steps missing or incoherent") is the best fit rather than anchor 2, which requires a rough sequence to be present. | 1 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the body is under 50 lines, so no external references are needed — but the only structure is a placeholder header "# Body" that signals nothing and the content is not organized. This lands at anchor 3: some structure exists, but it is not well-organized enough for the simple-skill score of 5, and there is no inlined content or buried referencing that would justify anchor 2. | 3 / 5 |
Total | 8 / 20 Passed |