Content
93%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 excellent example of a lean, repo-specific procedural skill: a concrete numbered checklist, an executable template, a precise skip_units contract with the authoritative source named, and explicit test commands. The only meaningful gap is the absence of an error-recovery loop in the Testing section, which keeps workflow clarity just below top marks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is repo-specific contract Claude cannot infer — the sourced-module/exit semantics, the skip_unless usage rules (command vs. path vs. chained requirements vs. message format), exact registration positions ('among the source lines', 'positioned per the Order matters comment'), and the test flags. No section explains concepts Claude already knows, and nothing is padded. | 5 / 5 |
Actionability | The guidance is fully executable: a copy-paste-ready install.sh template with the lib/skip.sh guard pattern, exact test commands ('bash mymodule/install.sh --non-interactive --overwrite --allow'), exact file paths (config.sh.example, bash/exports.sh, homebrew/bundle), and named reference modules for each pattern. The README spec bullets make step 2 concrete rather than vague. | 5 / 5 |
Workflow Clarity | The numbered checklist gives a clear, correctly ordered sequence (create -> README -> install.sh -> register -> packages -> root README -> config) with an explicit validation section (test standalone, then via main installer). It falls short of anchor 5 only because the Testing section lacks an error-recovery feedback loop — there is no 'if the test fails, check X and re-run' guidance, only the commands themselves. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and none are needed at this size: the body is well-sectioned into When/Checklist/Template/Testing/References, with one-level-deep, clearly signaled pointers ('lib/skip.sh holds the full contract'; four reference modules each annotated with the pattern it demonstrates). All inline content earns its place at authoring time. | 5 / 5 |
Total | 19 / 20 Passed |