Content
68%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 action-dense, well-structured, and respects Claude's intelligence, with strong CLI reference coverage. The main weakness is missing validation/feedback loops around destructive and batch operations, which caps workflow clarity.
Suggestions
Add validation/verification steps around destructive and batch commands — e.g., run `hivemind skillify pull --dry-run` before `--force`, confirm member list before `remove`, or verify deps before `embeddings uninstall --prune`.
Consider moving the long skillify and embeddings command references into a separate reference file (e.g. references/cli.md) and keeping SKILL.md as a tighter overview with a pointer.
De-duplicate the "do NOT quote subcommands together" note so it appears once near the top of the command sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence, with dense command references and no explanation of concepts Claude already knows; only minor trim opportunities like the repeated "do NOT quote subcommands together" warning. It is not a 5 because a couple of chatty/guarding lines could still be tightened. | 4 / 5 |
Actionability | It provides concrete, copy-paste-ready commands across org management, skillify, and embeddings with flags documented (e.g. `hivemind skillify pull --user <email>`, `cat file.json | jq 'keys | length'`). It is not a 5 because dynamic placeholders (<AUTH_CMD>, <session>, <user>) and the absence of a single fully-resolved worked example leave minor gaps. | 4 / 5 |
Workflow Clarity | The "How to Search" section is a clear 4-step sequence with a guard against jumping to raw JSONL, and a retry limit checkpoint exists. It is capped at 3 because destructive/batch operations (unpull, remove member, push, embeddings uninstall --prune) lack validation or verify-before/after feedback loops, which the rubric requires. | 3 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are empty) and the body is well-organized with clear section headers plus a directory tree. It is not a 5 because at ~100 lines the dense skillify/embeddings command references could reasonably be split into a separate reference file rather than fully inlined. | 4 / 5 |
Total | 15 / 20 Passed |