Content
11%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 unimplemented placeholder: a single header and a TODO with no instructions, examples, workflow, or references. It cannot guide the agent in any way and needs the actual skill instructions written.
Suggestions
Replace the TODO with concrete, executable instructions or code examples that tell the agent exactly what to do.
If the skill is multi-step, add a numbered workflow with explicit validation/checkpoint steps.
Organize content into clear sections and, for larger material, split details into one-level-deep reference files with signaled links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is only a header plus a TODO placeholder, so it is short but conveys no usable information; while not verbose, the tokens do not earn their place, placing it noticeably below the midpoint rather than at the lean/efficient score-5 anchor. | 2 / 5 |
Actionability | "TODO: Add instructions for how the agent should execute this skill" provides no concrete code, commands, or steps — it only notes that guidance is missing, matching the score-1 anchor ("Entirely vague or abstract; no concrete code or commands"). | 1 / 5 |
Workflow Clarity | There are no steps, sequence, or validation checkpoints — only a TODO marker, matching the score-1 anchor ("Steps missing or incoherent; no sequence"). | 1 / 5 |
Progressive Disclosure | Structure is minimal (one header and a TODO) with no sectioning or references to organize content, fitting the score-2 anchor ("Minimal structure"); it is not a 1 because it is not a monolithic wall of text or deeply nested references. | 2 / 5 |
Total | 6 / 20 Passed |