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 exemplary lean, fully executable CLI reference with perfect token efficiency and organization. Its one weakness is the absence of validation/verification guidance around batch and destructive operations (update --all --force, publish), which the rubric caps at 3 for workflow clarity.
Suggestions
Add a verification step for batch updates, e.g. after "clawhub update --all --force", run "clawhub list" to confirm installed versions and roll back with "clawhub install <skill> --version <previous>" if an upgrade breaks a skill.
Add a pre-publish checklist (e.g. confirm "clawhub whoami" succeeds and review the changelog/version bump) so the destructive publish step validates before overwriting registry state.
Briefly note what "hash-based match" means operationally during update (what happens when a local skill has no matching remote version), since that failure path is currently undocumented.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean command-per-section reference with zero over-explanation: "Install", "Auth (publish)", "Search", "Update", "Publish", and a short Notes list. Every token earns its place and nothing explains concepts Claude already knows. | 5 / 5 |
Actionability | Fully executable copy-paste commands covering common cases, including flag variants ("clawhub install my-skill --version 1.2.3", "clawhub update --all --no-input --force", a complete publish invocation with --slug/--name/--version/--changelog). Not level 4 because there are no gaps: the examples cover the common cases for every subcommand shown. | 5 / 5 |
Workflow Clarity | Sections are labeled and commands sequenced per task, but batch/destructive operations ("clawhub update --all --force", "clawhub publish") have no validation or verification steps — e.g. running "clawhub list" after update or confirming the published version. Per the rubric, missing validation on destructive/batch operations caps workflow clarity at 3 even for a single-purpose skill; it is not 2 because the sequence and commands themselves are clear and unambiguous. | 3 / 5 |
Progressive Disclosure | A short (~30 content lines), single-purpose reference with well-organized labeled sections and no external bundle files needed; no references exist in references/, scripts/, or assets/, so the inline-only structure is appropriate for this size, matching the simple-skill 5 anchor. | 5 / 5 |
Total | 18 / 20 Passed |