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 body is an empty template stub: a title plus a TODO placeholder with no instructions, code, steps, or structure. The skill as written cannot guide an agent to do anything.
Suggestions
Replace the TODO with the actual execution steps for the skill (e.g., exact commands or code the agent should run), which is the primary gap for actionability.
If the skill involves multi-step or batch/destructive operations, sequence the steps and include explicit validation checkpoints (validate → fix → retry).
Organize the body into clear sections (e.g. a quick-start section plus 'See X.md' pointers) so any detail content is progressively disclosed rather than left as a placeholder.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is only two lines with no padding, but the single sentence is a placeholder that earns no place in context; it is neither verbose nor genuinely lean-and-useful, sitting at the midpoint. | 3 / 5 |
Actionability | "TODO: Add instructions for how the agent should execute this skill" provides no concrete code, commands, or steps — it only marks that guidance is missing, matching the 'entirely vague' anchor. | 1 / 5 |
Workflow Clarity | No steps or sequence of any kind are present; the body contains only an unfulfilled TODO marker, so there is no workflow to follow or validate. | 1 / 5 |
Progressive Disclosure | Structure is minimal — a single heading and one TODO line with no organized sections and no references, and the under-50-line exception does not apply because there are no well-organized sections to navigate. | 2 / 5 |
Total | 7 / 20 Passed |