Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a dense, actionable CLI reference with clear search workflow guidance and good section organization. Its main weaknesses are a destructive-operation gap in validation checkpoints, repeated warnings, and a monolithic inline structure with no progressive disclosure despite its length.
Suggestions
Add validation/verification steps before destructive commands (e.g., 'skillify push --dry-run first; only --force after confirming the diff') to raise workflow clarity above 2.
De-duplicate the 'do NOT quote subcommands together' warning (state it once) and consider a shared prefix note to tighten conciseness.
Move the large skillify/embeddings command catalogs into reference files linked from SKILL.md to improve progressive disclosure for this 95-line skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean command reference with no concept explanations Claude already knows, but the 'do NOT quote subcommands together' warning is repeated across two sections and command prefixes are restated on every line, so it is 'mostly efficient but could be tightened' (anchor 2) rather than every-token-earns-its-place (anchor 3). | 2 / 3 |
Actionability | It provides concrete, copy-paste-ready commands throughout (e.g., 'hivemind skillify pull', 'grep -r "keyword" ~/.deeplake/memory/'), and the '<path>' placeholder is explicitly justified ('or check the session context for the resolved path'), matching anchor 3 ('Fully executable code/commands; copy-paste ready'). | 3 / 3 |
Workflow Clarity | The 'How to Search' section gives a clear index→summary→raw-JSONL sequence with a retry limit, but destructive operations such as 'skillify push --force' (overwrites) and 'skillify unpull' (removes skills) have no validation/verification checkpoints, which per the scoring notes caps workflow clarity at 2. | 2 / 3 |
Progressive Disclosure | Sections are well-organized with headers, but the skill is over 50 lines with all content inline and no external references signaled; large command catalogs (skillify, embeddings) that could live in separate files are inline, fitting anchor 2 ('Some structure... content that should be separate is inline') rather than anchor 3's split-with-navigation. | 2 / 3 |
Total | 9 / 12 Passed |