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.
A dense, largely executable command reference with good section organization and a clear memory-read workflow. Its main weaknesses are the absence of validation steps around destructive member/skill/embedding operations and unresolved path placeholders for the auth command.
Suggestions
Add verification steps before destructive operations, e.g. run 'members' to confirm the user ID before 'remove <user-id>', and recommend '--dry-run' before 'skillify pull --force' or 'embeddings uninstall --prune'.
Resolve the auth command path once at the top and use that single concrete invocation throughout, removing the '$PLUGIN_ROOT ... or check the session context' and '<AUTH_CMD>' inconsistency.
Deduplicate the repeated 'Each argument is separate' note into one place and fold 'Getting Started' into the Organization Management section to trim redundant tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean command reference with no explanations of concepts Claude already knows; only minor trimming is needed — 'Each argument is separate — do NOT quote subcommands together' is repeated in both the Organization Management and Skill Management sections, and 'Getting Started' re-states the auth command already listed above. Anchor 4, not 5. | 4 / 5 |
Actionability | Highly concrete throughout: exact grep commands, the full auth-login.js subcommand list, and a complete skillify flag reference. Minor gaps keep it below anchor 5: the auth script path is an unresolved placeholder ('$PLUGIN_ROOT/bundle/commands/auth-login.js ... or check the session context', later '<AUTH_CMD>'), and the availability of the 'hivemind' CLI on PATH is never stated. | 4 / 5 |
Workflow Clarity | 'How to Search' is a well-sequenced 4-step read path (index → summaries → raw JSONL → grep) with an explicit 'Do NOT jump straight to reading raw JSONL' guardrail, but the skill includes destructive and batch operations (remove <user-id>, skillify unpull, embeddings uninstall --prune, skillify pull --force) with no validation or verification steps such as confirming a user ID via 'members' or running --dry-run before destructive runs — the rubric caps this at 3. | 3 / 5 |
Progressive Disclosure | No bundle files exist, and the single-file body is well-sectioned with clear headers and a memory-structure tree that make each area scannable. Minor gaps: ~100 lines of CLI reference (the skillify flag list alone is ~25 lines) that could live in a separate reference file, and the auth-login.js pointer reaches outside the skill without clear signaling. Anchor 4, not 5 — not an ideal split with well-signaled one-level-deep references. | 4 / 5 |
Total | 15 / 20 Passed |