Content
37%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 content-free: two words that instruct nothing. While maximally token-efficient, it fails actionability and workflow clarity completely, and its single heading conveys no organization. It needs actual executable guidance for whatever the skill is supposed to do.
Suggestions
Replace "Use it." with concrete, executable guidance — specific commands, code, or unambiguous instructions covering the skill's common cases.
If the task involves multiple steps, lay them out as an explicit numbered sequence with validation checkpoints for risky operations.
Give the section heading a meaningful, task-relevant name (e.g., "## Quick start") and organize any detail content into clearly signaled sections or reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body ("# Body\n\nUse it.") contains zero verbosity, padding, or explanation of things Claude already knows — none of the verbosity-based failure modes at anchors 1–4 apply. The lack of any substance is penalized under actionability and workflow_clarity, not here. | 5 / 5 |
Actionability | "Use it." is entirely vague — no concrete code, commands, or specific steps, and it doesn't even specify what "it" refers to. This matches anchor 1 (entirely vague, no concrete guidance); anchor 2 at least gives high-level hints toward execution. | 1 / 5 |
Workflow Clarity | No steps or sequence of any kind are present — the body is a single instruction-free sentence. The simple-skill exception cannot apply because "Use it." is not an unambiguous single action; it specifies nothing about what to do. | 1 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files, but the lone heading "# Body" is uninformative and provides no organizational or navigation value, so the simple-skill path to 5 (well-organized sections) is not met. It has minimal structure without inlined misplaced content, landing at anchor 3 rather than 4, which requires appropriately placed content and clear references. | 3 / 5 |
Total | 10 / 20 Passed |