Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable reference of copy-paste commands organized by operation. It loses a step on workflow clarity because the publish/update flows lack validation or pre-flight checks for operations that are effectively irreversible.
Suggestions
Add a pre-publish validation step (e.g. run 'clawhub whoami' to confirm auth, then a dry-run/version check) so the publish workflow has an explicit checkpoint before the irreversible upload.
Include a brief verify step after 'clawhub update --all' (e.g. 'clawhub list' to confirm versions resolved) to close the feedback loop on batch updates.
Sequence the publish command as an ordered list (login -> whoami -> publish) rather than a bare code block so the multi-step nature is explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, command-only body with no filler or explanations of concepts Claude already knows; every line earns its place, matching the 'lean and efficient' anchor. | 3 / 3 |
Actionability | Fully executable, copy-paste-ready commands with concrete flags (e.g. 'clawhub install my-skill --version 1.2.3', 'clawhub update --all --no-input --force') throughout. | 3 / 3 |
Workflow Clarity | Commands are grouped by task but lack validation checkpoints; publish is a batch/irreversible-style operation with only an optional 'whoami' and no verify-before-publish feedback loop, which caps this at 2 per the scoring notes. | 2 / 3 |
Progressive Disclosure | Under 50 lines, single-purpose CLI skill with no need for external references; the well-organized per-command sections satisfy the simple-skill exception for a top score. | 3 / 3 |
Total | 11 / 12 Passed |