Content
67%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 content is a well-structured, actionable discovery guide with concrete commands and clear routing. Its main weakness is token efficiency: redundant command examples and generic best-practice tips inflate the body without adding capability Claude lacks.
Suggestions
Collapse the three "Search Strategies" subsections into a single block showing `npx clawhub search "<keyword>"` with a few argument variants (`--sort installs`, `--sort stars`), instead of repeating the same command nine times.
Trim generic Best Practices and Installation Tips that Claude already knows (e.g. "Check for updates regularly", "Read documentation", "Test thoroughly") and keep only skill-specific guidance.
Add a short "Which source to try first" decision note (e.g. ClawHub first, then the directories, then GitHub) to give the discovery flow an explicit sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly scannable lists, but it pads repeated near-identical `npx clawhub search` command blocks across three subsections and includes generic advice ("Check for updates regularly", "Read documentation", "Test thoroughly") that Claude already knows, so it could be tightened. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready commands (`npx clawhub search "keyword"`, `npx clawhub browse`, `--sort installs`) and direct URLs for each source, with only minor gaps such as no example output and a couple of referenced commands shown without full syntax. | 4 / 5 |
Workflow Clarity | As a simple single-purpose skill it is well organized with clear When-to-Use / When-NOT-to-Use routing and a small numbered troubleshooting sequence, though it lacks an explicit decision flow for which source to try first. | 4 / 5 |
Progressive Disclosure | Section structure is clear and a single file is appropriate for a guide of this kind (no bundle files exist), but the long inline "Common Skill Categories" catalog is reference-like content that could be split out, leaving minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |