Content
77%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 well-structured operational skill: intent routing, concrete CLI commands, guarded install checkpoints, and a clean split of platform details into real reference files. The weakest spots are a version-number dependency in the config guidance and one externally deferred command in the history-mining flow.
Suggestions
Move the 'Since v0.4.11' version-dependent .memsearch.toml note into a short 'Version notes' or deprecated-behavior section so the mainline guidance stays evergreen.
Inline the exact transcript-drill command (or at least a one-line example of it) in section C instead of deferring to the memory-recall skill's platform reference, so the flow is executable from this skill alone.
Trim rationale sentences like the background-pass comparison at the end of section C to keep only the actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean instruction, but it embeds time-sensitive version information ('Since v0.4.11, project-local .memsearch.toml accepts only allowlisted local indexing keys') outside any deprecated/old-patterns section, which the rubric penalizes, plus trimmable rationale sentences ('The background pass mines automatically when enabled... so the result can be more accurate'). Not 4 because these are more than minor instances; not 2 because there is no padding explaining concepts Claude already knows. | 3 / 5 |
Actionability | Provides copy-paste-ready commands for the core flows — the full 'memsearch skills add --name ... --body-file -' invocation with a printf example, 'skills status/list', 'git -C .memsearch/skill-candidates log', and the config get/set commands. Not 5 because the transcript drill in section C, a key operation, defers the exact command to 'the memory-recall skill's platform reference', which is outside this bundle; clearly above 3 since the given commands are executable, not pseudocode. | 4 / 5 |
Workflow Clarity | The A/B/C/D flows are clearly sequenced with explicit validation and feedback loops: 'if a step looks uncertain or loosely summarized, re-check it against the source... or flag it to the user', 'reinstall only after reviewing the candidate', an interactive install checkpoint with destination confirmation, and empty-list branching in B. Destructive/batch operations (install, config changes) are guarded by explicit confirmation steps and the Guardrails section, so no cap applies. | 5 / 5 |
Progressive Disclosure | Platform-specific config-prefix and install-path details are correctly split into five real one-level-deep reference files (references/claude-code.md, codex.md, openclaw.md, opencode.md, dsh.md — all present in the bundle), each clearly signaled with a platform mapping list up front, and the body keeps only the cross-platform workflow. Matches the clear-overview with well-signaled one-level references anchor. | 5 / 5 |
Total | 17 / 20 Passed |