Content
86%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.
An actionable, well-structured retrieval workflow with copy-paste commands and sensible fallbacks; only minor conciseness trimming and an implicit (rather than explicit) validation checkpoint keep it from a perfect score.
Suggestions
Trim meta-instructions that restate Claude's own competence (e.g. "Be concise — only include information that is genuinely useful", "it is the source of truth for memory") to tighten the token budget.
Make the Evaluate step an explicit validation checkpoint (e.g. "If all top-k chunks are irrelevant, retry with a reformulated query before returning 'No relevant memories found'") to strengthen the workflow loop.
Consolidate the three repeated MDIR assignment snippets in the "When unsure" section into one defined variable used by all three commands to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and command-driven, but a few lines pad what Claude already knows ("it is the source of truth for memory", "Be concise — only include information that is genuinely useful") that could be trimmed without losing clarity. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands are given throughout — `memsearch search ... --top-k 5 --json-output`, `memsearch expand <chunk_hash>`, `memsearch transcript ... --turn <uuid> --context 3` — with a `uvx memsearch` fallback and concrete MDIR shell snippets. | 5 / 5 |
Workflow Clarity | Steps 1-5 are clearly sequenced with an Evaluate filtering checkpoint and error-recovery fallbacks (tool missing → uvx, unrecognized format → read file directly), but it lacks an explicit validate/retry loop; read-only retrieval means no destructive-operation cap applies. | 4 / 5 |
Progressive Disclosure | The body is a compact, single-purpose instruction set under ~50 lines with no bundle files to disclose, and is organized into clear sections (Project Collection, Steps, When unsure, Output Format), satisfying the simple-skill exception for a 5. | 5 / 5 |
Total | 18 / 20 Passed |