Content
85%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, highly actionable skill body: clear intent routing, copy-paste CLI commands, explicit verification and confirmation checkpoints, and platform specifics correctly split into one-level-deep reference files that all exist. The only weaknesses are minor — an external reference dependency in flow C and a small amount of trimmable rationale plus one version-number note.
Suggestions
Inline the transcript-drill command (or a pointer to a file inside this skill's bundle) in flow C instead of referencing the memory-recall skill's platform reference, so the workflow is fully executable from this skill alone.
Trim rationale passages like the on-demand vs background-mining comparison in C to a single sentence, and move the "Since v0.4.11" config caveat into a clearly-labeled compatibility/notes line so the version reference reads as scoped guidance rather than dated prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative, and nearly all of it is MemSearch-specific operational detail Claude cannot already know. Not 5 because a few passages could be trimmed (e.g. the rationale for on-demand mining in C) and the bare version number "Since v0.4.11..." is time-sensitive content outside a deprecated/old-patterns section; not 3 because the padding is minor rather than a pattern. | 4 / 5 |
Actionability | Concrete, copy-paste commands throughout: `memsearch skills add --name ... --body-file -`, `skills status`, `skills list`, `git -C .memsearch/skill-candidates log`, and exact `config get/set` invocations. Not 5 because flow C defers the transcript-drill command to "the memory-recall skill's platform reference" — an external dependency not in this bundle — leaving a gap in executability. | 4 / 5 |
Workflow Clarity | Intent routing disambiguates requests up front; each flow is clearly sequenced with explicit validation checkpoints ("Be exact — do not guess", re-check candidates against source before install, confirm install destination, fallback chain "Only if that command fails... fall back to reading the raw file", "never fabricate"). The install step — the closest thing to a batch/destructive operation — is an interactive checkpoint with user confirmation, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with an explicit platform-to-reference-file map; all five referenced files (claude-code.md, codex.md, openclaw.md, opencode.md, dsh.md) exist in references/, are one level deep, and contain exactly the platform-specific config/install-path detail kept out of the main body. No nesting, easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |