Content
47%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 admirably lean but hollow: it delegates all detail to a guide.md that does not exist in the bundle and gives only vague, non-executable instructions for the two core steps. With the referenced files missing, the skill provides no actionable path for a reader to actually extract data or apply the template.
Suggestions
Provide the actual runnable commands, e.g. `python extract.py <source>` with expected arguments/output, and show concretely what 'apply template.txt' means (a command or a short example).
Fix the bundle: either include guide.md, extract.py, and template.txt in the skill directory or inline the essential instructions, since the current primary reference is a dangling pointer.
Add a lightweight validation step (e.g. how to verify the extracted data or formatted output looks correct) so the two-step workflow has a checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is roughly five lines with no padding and no explanation of concepts Claude already knows ("This skill uses a flat directory layout instead of the standard structure" is one brief factual line). It matches the anchor 'Lean and efficient; every token earns its place'; it cannot exceed 5, and it is well above anchor 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | The instruction "Run extract.py to extract data from the source, then apply template.txt to format the output" names files but gives no runnable command, arguments, or explanation of how to 'apply' a template. This matches anchor 2 ('high-level hints but missing the specific steps to execute'); it is above anchor 1 because specific files are named, but below anchor 3, which requires at least some concrete executable detail. | 2 / 5 |
Workflow Clarity | A rough two-step sequence exists (extract, then format), but the steps are poorly defined — how to run the script, what 'the source' is, and what applying a template means are all unstated, and there is no validation of any kind. This matches anchor 2; anchor 3 would require steps that are actually defined even if validation is missing, and this is not a destructive/batch operation so no further cap applies. | 2 / 5 |
Progressive Disclosure | The body points to guide.md, extract.py, and template.txt, but none of these files exist in the bundle (only SKILL.md is present), so the primary navigation path ('Refer to guide.md for detailed instructions') is broken and the actual instructions are unreachable. Scored against the actual bundle structure per the guidelines, this is 'minimal structure; references buried/broken' (anchor 2); it is above anchor 1 because the body itself is short and one-level-deep rather than a monolithic wall, but below anchor 3 because the referenced files are missing rather than merely unclear. | 2 / 5 |
Total | 11 / 20 Passed |