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 instruction skill: concrete executable commands, an explicit staged workflow with interactive checkpoints and fallbacks, and correct use of one-level-deep platform reference files. The weakest spots are the deferred transcript-drill command and a version-number note that belongs in a clearer place, keeping actionability and conciseness at 4.
Suggestions
Inline the exact transcript-drill command (or a one-line example of it) in section C instead of deferring to the memory-recall skill's platform reference, so the core mining flow is fully executable from this file.
Move the 'Since v0.4.11' project-local config note into a short 'Version-specific notes' or deprecated-patterns section so time-sensitive version details don't sit in the main flow.
Trim rationale sentences (e.g. 'so the result can be more accurate' in section C) to tighten the body without losing the operational guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Imperative and command-dense with no re-teaching of known concepts, but a version-number reference ('Since v0.4.11, project-local .memsearch.toml...') sits in the main flow rather than a deprecated section, and a few rationale sentences ('so the result can be more accurate') could be trimmed. | 4 / 5 |
Actionability | Mostly copy-paste-ready bash (skills add/status/list/install, exact config get/set keys, the printf --body-file pipeline), but the history-mining transcript drill defers the exact command to another skill's reference file, a minor gap. | 4 / 5 |
Workflow Clarity | Clear intent routing and staged 0→1→2 flow with explicit validation checkpoints (hash-based 'skills status', 'Before recommending or installing, skim the candidate's body'), an error-recovery fallback ('Only if that command fails... fall back to reading the raw file directly'), and a guardrails checklist. | 5 / 5 |
Progressive Disclosure | The body is a concise overview with clearly signaled one-level-deep platform references; all five referenced files (references/claude-code.md, codex.md, dsh.md, openclaw.md, opencode.md) exist in the bundle and match the body's pointers. | 5 / 5 |
Total | 18 / 20 Passed |