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.md body is an unfilled scaffold: every section heading is appropriate, but all content beneath them is placeholder text ('Describe...', 'List any...'), no step is concrete, and the two referenced script files do not exist in the bundle. Actionability and workflow clarity are at the floor; only the section structure keeps progressive disclosure and conciseness slightly above it.
Suggestions
Replace every placeholder sentence with actual executable guidance — concrete commands showing how to invoke scripts/process.py and scripts/analyze.py (arguments, expected inputs/outputs), and real usage examples instead of '[do something]'.
Add the referenced scripts/process.py and scripts/analyze.py files (or remove the 'Tools Available' references), since the bundle currently contains no scripts, references, or assets at all.
Write an actual workflow: a numbered sequence with explicit validation/verification steps for any risky operations, and populate 'When to Use', 'Prerequisites', and 'Configuration' with real conditions, packages, and settings.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short (~30 lines) with no verbosity or over-explanation of known concepts, so it avoids the verbose anchors (1–2), but the tokens are placeholders like 'Clear instructions for the agent on how to use this skill.' that carry no instructional value — 'every token earns its place' (anchor 5) is not met, and anchor 4's 'minor instances of over-explanation' doesn't fit contentless text either. This lands at the midpoint: no waste through padding, but no earned tokens either. | 3 / 5 |
Actionability | The entire body is unfilled template text: 'Describe the situations where this skill should be activated.', 'When the user asks to [do something], use this skill to [accomplish it].', 'List any required packages or tools.' There is no concrete code, no runnable command, and no specific instruction — matching anchor 1 ('Entirely vague or abstract; no concrete code or commands; only describes rather than instructs'). Even the listed tools get only 'Description of what this script does' with no invocation syntax, so it cannot reach 2. | 1 / 5 |
Workflow Clarity | No sequence of steps exists anywhere — the sections are headings over placeholder sentences, with no ordering, no commands, and no validation checkpoints. This matches anchor 1 ('Steps missing or incoherent; no sequence; no validation for risky operations'); score 2 would require at least a rough sequence, which is absent. | 1 / 5 |
Progressive Disclosure | The body has section headers and is under 50 lines (which could support a high simple-skill score), but its only external references — 'scripts/process.py' and 'scripts/analyze.py' — do not exist in the bundle (no scripts/, references/, or assets/ directories), so the disclosure structure is nominal: navigation points to nothing. This falls between anchor 1 (impossible-to-navigate nested references) and anchor 3 (structure present, references signaled) — the sections exist but every referenced path is dangling, so it sits noticeably below the midpoint. | 2 / 5 |
Total | 7 / 20 Passed |