Content
78%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 body is a highly actionable, well-sectioned reference with concrete commands, paths, and a clear search workflow with an error-recovery rule. Its main weakness is progressive disclosure: a sizable skillify/embeddings CLI reference is inlined in SKILL.md with no external files to offload detail.
Suggestions
Move the full 'Skill Management (skillify)' flag enumeration and 'Embeddings' command list into a references/ file (e.g., references/skillify-cli.md), keeping only the 3-4 most common commands inline with a clearly signaled link.
Consolidate the duplicated note 'Each argument is separate — do NOT quote subcommands together' into one statement near the first command block.
Add a short validate-before-acting step for mutating org operations (e.g., run 'node "<AUTH_CMD>" members' or '--dry-run' before remove/unpull) to give the management workflows an explicit checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense reference material with no explanations of concepts Claude already knows (concrete paths like '~/.deeplake/memory/index.md' and one-line command descriptions throughout). Minor trimmable redundancy exists — 'Each argument is separate — do NOT quote subcommands together' appears in both Organization Management and Skill Management — matching anchor 4 ('efficient; minor instances that could be trimmed') rather than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Quotes: exact file paths ('~/.deeplake/memory/summaries/<session>.md'), a concrete Grep invocation ('Grep pattern="keyword" path="~/.deeplake/memory"'), and copy-paste-ready commands covering common cases ('node "<AUTH_CMD>" org switch <name-or-id>', 'hivemind skillify pull --dry-run'). The one placeholder (<AUTH_CMD>) is explicitly justified ('The auth command path is injected at session start'), so this is fully actionable rather than having minor gaps. | 5 / 5 |
Workflow Clarity | 'How to Search' is a clear escalating sequence (1. index.md → 2. summary → 3. raw JSONL → 4. keyword Grep) with an explicit checkpoint ('Do NOT jump straight to reading raw JSONL files'), and 'Limits' supplies a recovery loop ('If a file returns empty after 2 attempts, skip it and move on'). Not anchor 5 because there is no validate-then-proceed cycle for the org-management and skillify push/unpull operations whose commands are listed but not sequenced. | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/ directories), and the body inlines what is effectively a CLI flag reference — the ~24-line 'Skill Management (skillify)' enumeration plus 'Embeddings' command list — that belongs in a separate reference file to keep SKILL.md a lean overview. This matches anchor 3 ('content that should be separate is inline'); structure itself is good, so it is above anchor 2's 'minimal structure'. | 3 / 5 |
Total | 16 / 20 Passed |