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.
The body is well-structured, actionable, and uses progressive disclosure effectively with real reference files, strong workflow sequencing, and explicit validation checkpoints around the install step. Its main weakness is a subtle bug in the headline capture command plus some repeated accuracy guardrails that could be tightened.
Suggestions
Fix the section-A capture example: `printf '%s' "...\n..."` writes literal backslash-n; use `printf '## %s\n\n1. ...\n2. ...\n' "<title>"` or a heredoc so the candidate body gets real newlines.
Consolidate the repeated 'be exact / do not guess / never fabricate' guidance into one statement in section A and reference it from B and C, to trim tokens without losing the safeguard.
Consider moving the v0.4.11 `.memsearch.toml` allowlist note into the platform reference files, since it is version/time-sensitive and the rubric penalizes such details in the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with concrete commands and assumes Claude's competence, but the accuracy exhortations ("Be exact — do not guess", "never fabricate", "a wrong command is worse than a vague one") recur across sections A, B, and C and could be consolidated. Not a 5 because of that repeated hedging; not a 3 since most tokens earn their place. | 4 / 5 |
Actionability | Provides copy-paste-ready bash throughout (memsearch skills add/status/list/install, config get/set, git log) covering capture, review, install, and configure. Capped below 5 because the marquee section-A example `printf '%s' "## <title>\n\n1. ..."` emits literal backslash-n rather than newlines (printf %s does not interpret escapes), so the headline command as written produces a malformed skill body. | 4 / 5 |
Workflow Clarity | Clear staged sequence (0→1→2) with intent routing to A/B/C/D and explicit validation checkpoints: skim and re-check the candidate body before install ("last chance to catch a wrong step"), confirm the install destination with the user, and drill into the transcript when a step is uncertain. The semi-destructive install step has the review checkpoint the rubric requires, so the destructive cap does not apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is a concise overview that splits platform-specific config-key prefixes and install paths into one-level-deep, clearly signaled reference files (references/claude-code.md, codex.md, dsh.md, openclaw.md, opencode.md — all present and verified), each referenced via a platform→file bulleted map for easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |