Content
18%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 skill body is essentially a placeholder — a title and one descriptive sentence with no actionable guidance, workflow, or structure. It conveys almost nothing useful about how to perform the skill.
Suggestions
Add concrete, executable guidance (commands or code examples) for the skill's primary action instead of a single descriptive sentence.
If the skill involves a multi-step or destructive/batch process, lay out a numbered sequence with an explicit validation checkpoint.
Organize the body into clear sections (e.g., a Quick start header) so the overview is navigable, and move any bulk detail into one-level-deep reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body ('This skill has a complex frontmatter block.') is terse with no padding, but its few tokens carry no useful information, so it is efficient yet vacuous — between anchors 3 and 5, settling on 3 because the minimal text does not meaningfully earn its place. | 3 / 5 |
Actionability | It provides no concrete code, commands, or specific steps — it only vaguely describes the skill rather than instructing, matching the 'entirely vague or abstract' anchor. | 1 / 5 |
Workflow Clarity | There are no steps, sequence, or validation; the single action is unspecified, so the simple-skill exception does not apply and it matches the 'steps missing; no sequence' anchor. | 1 / 5 |
Progressive Disclosure | The body has no section structure or navigation beyond a title and one sentence, matching 'minimal structure'; it is not a score-1 wall of text with nested refs but lacks the organization needed for a 3. | 2 / 5 |
Total | 7 / 20 Passed |