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.
An efficiently organized, fully executable CLI cheat-sheet that is copy-paste ready. Its main gap is the absence of validation/verification guidance for consequential batch and publish operations, which caps workflow clarity.
Suggestions
Add a pre-publish validation step, e.g. "clawhub publish --dry-run" or a check that the skill folder has a valid SKILL.md before running the real publish.
Before "clawhub update --all --force", document a preview step (e.g. "clawhub list" or a "--dry-run") so changes can be reviewed before applying batch forced upgrades.
Add a brief sequenced workflow for the publish path (login → verify folder → publish → confirm with clawhub whoami/search) with an explicit checkpoint after each step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean section-and-command structure with no concept over-explanation ("Install\n```bash\nnpm i -g clawhub\```"); every token earns its place and assumes Claude's competence. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands for every operation, including common-case variants ("--version 1.2.3", "--all --no-input --force", publish with slug/name/version/changelog flags). | 5 / 5 |
Workflow Clarity | Sections are grouped (install → auth → search → update → publish) but no validation checkpoints exist for batch/destructive operations like "clawhub update --all --force" and "clawhub publish", which the rubric caps at 3. | 3 / 5 |
Progressive Disclosure | A simple single-purpose CLI reference with well-organized section headers and no need for external files; no bundle files exist and nothing is buried or nested, so the simple-skill exception applies. | 5 / 5 |
Total | 18 / 20 Passed |