Content
87%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 lean, well-organized, and highly actionable with copy-paste npx commands, but it lacks explicit validation checkpoints for the state-changing install and batch update operations. Adding a verify step after install/update would lift workflow clarity above its current cap.
Suggestions
Add an explicit validation step after install or update, e.g. run 'clawhub list --workdir ...' and confirm the skill appears before advising a new session.
Frame the 'List installed' command as a verification checkpoint within the install/update workflow rather than only as a standalone capability.
Note how to handle a failed install or update (error inspection and retry) to introduce a feedback loop for the batch update operation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and sectioned with no concept-explanation padding; every line (commands, flags, Notes) earns its place operationally, matching the anchor for efficient content that assumes Claude's competence. | 5 / 5 |
Actionability | Provides fully executable, copy-paste-ready npx commands for search, install, update, and list with concrete flags and a worked search example, matching the anchor for fully executable guidance covering common cases. | 5 / 5 |
Workflow Clarity | A logical sequence is present (search, install, update, list) but 'update --all' is a batch operation and install is state-changing with no explicit validation checkpoint, so workflow clarity is capped at 3 per the destructive/batch guideline. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, has no bundle files, and is organized into clear sections (When to use, Search, Install, Update, List, Notes), qualifying for the simple-skill exception that allows a 5. | 5 / 5 |
Total | 18 / 20 Passed |