Content
65%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 and uses dynamic injection appropriately, but its guidance is incomplete: the helper script is never given as an executable command, the report output is unspecified, and the central reference.md link points to a file that does not exist. The skeleton is good; the executable details are missing.
Suggestions
Give the exact helper invocation, e.g. `bash ${CLAUDE_SKILL_DIR}/scripts/helper.sh ${target:-.}`, instead of the vague 'Run the helper script using ${CLAUDE_SKILL_DIR}'.
Fix or remove the broken reference.md link — either add the file to the bundle or drop the reference and inline the essential material.
Specify what the final report should contain (e.g. sections for tree structure, key files, and observations) so 'Produce a report' is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~12-line body contains zero padding and no explanations of concepts Claude already knows; the heading, target line, injected command, reference, and three steps all earn their tokens, matching the 'lean and efficient' anchor. It avoids the anchor-4 territory because there is no over-explanation to trim at all. | 5 / 5 |
Actionability | The injected `find ${target:-.} -type f -maxdepth 2 | head -20` command is executable, but 'Run the helper script using ${CLAUDE_SKILL_DIR}' omits the actual command, 'Produce a report' specifies no output format, and the referenced reference.md does not exist — matching anchor 3's 'some concrete guidance but incomplete; missing key details'. It falls short of 4 because two of three steps cannot be executed as written. | 3 / 5 |
Workflow Clarity | A numbered 1-2-3 sequence is present, but the steps are underspecified (no helper invocation command, no report structure) and step 1 points to a nonexistent file, matching anchor 3's 'steps listed but gaps'. This is a non-destructive read/report skill so the validation cap does not apply, but it also does not qualify for the simple-skill exception because the steps are not unambiguous. | 3 / 5 |
Progressive Disclosure | References are one level deep and clearly signaled ('[reference.md](reference.md) and the helper in scripts/'), but the reference.md link is broken — the file does not exist in the bundle — and the body has minimal section organization, matching anchor 3's 'some structure but could be better organized'. It is above anchor 2 because nothing is inlined that belongs in a separate file and references are not buried. | 3 / 5 |
Total | 14 / 20 Passed |