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 an empty stub: one ambiguous instruction ('Use the tool.') under a placeholder header, with no concrete guidance, no steps, no examples, and no supporting files. While it wastes no tokens, it delivers zero actionable content — the skill body fails at everything except brevity.
Suggestions
Replace 'Use the tool.' with concrete, executable guidance: name the specific tool/command and show at least one runnable example.
If the skill involves a multi-step process, list the steps in order and add validation checkpoints where operations are risky.
Add short, purposeful section headers (e.g., '## Quick start') so the body is organized, and split any detailed reference material into one-level-deep files in references/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines ('# Body' / 'Use the tool.') with zero padding or explanations of known concepts, which is genuinely efficient. It falls short of the 5 anchor ('every token earns its place') because 'Use the tool.' earns nothing — the entire token budget is spent on a phrase that conveys no usable information. | 4 / 5 |
Actionability | The only guidance is 'Use the tool.', which names no tool, command, or step — matching 'Entirely vague or abstract; no concrete code or commands; only describes rather than instructs'. It is not 2 because even a high-level hint of a specific step is absent. | 1 / 5 |
Workflow Clarity | There is no sequence of steps at all — the body contains a single incoherent instruction with no defined process, matching 'Steps missing or incoherent; no sequence'. Even the simple-skill exception cannot apply because the one action is completely ambiguous ('the tool' is undefined). | 1 / 5 |
Progressive Disclosure | The body has a bare '# Body' header and one line with no organized sections, and no bundle files exist (references/, scripts/, and assets/ are absent), so nothing is disclosed or navigable — matching 'Minimal structure'. It is not 3 because there is not even 'some structure': no sections organize the content, and the single line gives no overview of anything. | 2 / 5 |
Total | 8 / 20 Passed |