Content
26%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 two content-free lines: a placeholder heading and the instruction 'Use the tool.' While it wastes no tokens (conciseness), it is entirely non-actionable, has no discernible workflow, and offers no structure or references. The body needs actual instructions — specific commands or code, an ordered procedure with validation if applicable, and meaningful section headings.
Suggestions
Replace 'Use the tool.' with concrete, executable guidance: name the specific tool/command to run and show a copy-paste-ready example covering the common case.
Give the skill real structure: replace the '# Body' placeholder with headings that reflect actual tasks (e.g. a quick-start section plus clearly signaled references if detail is needed).
If the task involves multiple or risky steps, list them as an ordered sequence with explicit validation checkpoints so the workflow is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body ('# Body' / 'Use the tool.') has no padding and no over-explanation, but the vacuous heading and the content-free instruction mean the few tokens present do not fully earn their place, so it sits just below the 'lean and efficient; every token earns its place' anchor. | 4 / 5 |
Actionability | 'Use the tool.' offers no concrete code, commands, or specifics and does not even identify which tool, matching the 'entirely vague or abstract; no concrete guidance' anchor. | 1 / 5 |
Workflow Clarity | There are no steps or sequence, and the single action is ambiguous about both the tool and the task, so the simple-skill exception (score 5 only for an unambiguous single action) does not apply; this matches the 'steps missing or incoherent' anchor. | 1 / 5 |
Progressive Disclosure | The only heading is the meaningless '# Body' with no organized sections, no references, and no navigation; this is minimal structure rather than the genuine organization required for the anchor above. | 2 / 5 |
Total | 8 / 20 Passed |