Content
67%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 a well-structured, mostly actionable workflow with concrete shell commands and a verification step. Its main weaknesses are mild redundancy between the Pitfalls/Troubleshooting/Example sections and a Step 1 that delegates rather than providing executable steps.
Suggestions
Collapse the 'Example Workflow' into the relevant steps or the Troubleshooting table to remove duplicated commands and tighten conciseness.
Make Step 1 executable by giving the literal shell_agent invocation or task-delegation syntax instead of a descriptive prompt template.
Add an inline validate->fix->retry loop (e.g. 'if find returns nothing, broaden the search; if the file is 0 bytes, re-run the task') to lift workflow clarity to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but the 'Common Pitfalls' and 'Troubleshooting' sections restate guidance already covered in the steps (find before assuming location, check file size), so it could be tightened; it is not a 2 because the padding is limited rather than pervasive. | 3 / 5 |
Actionability | Steps 2-4 give concrete, executable commands (find, cp/mv, ls, file) with realistic output examples; Step 1 is a descriptive delegation prompt rather than executable code, a minor gap that keeps it just below fully copy-paste ready. | 4 / 5 |
Workflow Clarity | A clear four-step sequence includes an explicit verify step (file size/exists) and a troubleshooting table for error recovery, satisfying 'clear sequence with most checkpoints'; it is not a 5 because the error-recovery loop is a reference table rather than an inline validate->fix->retry loop. | 4 / 5 |
Progressive Disclosure | The skill is self-contained with no bundle files and well-organized sections (When to Use, Steps, Pitfalls, Example, Troubleshooting); it is not a 5 because it runs slightly over the ~50-line simple-skill threshold and the Example Workflow duplicates commands from earlier sections. | 4 / 5 |
Total | 15 / 20 Passed |