Content
78%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 compact, self-contained instruction skill with concrete query filters, explicit config precedence, and clear error-path handling for missing setup. Its few imperfections — mild repetition in step 2, an assumed tool interface, and no output-verification step — keep most dimensions at 4.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no explanations of concepts Claude already knows — even the tricky CLAUDE_CONFIG_DIR edge cases ("do not trim it, expand ~, or treat an empty value as unset") are load-bearing rules. Step 2 mildly restates rules already implied by its bullet list ("Never run an unscoped coding-session query"), keeping it just below the lean 5 anchor. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: literal filter values ("filters={\"type\": \"task\", \"status\": \"active\"}"), named config keys, explicit precedence order, and a specified output format. Minor gaps — the bm_search tool invocation itself and tool-availability fallback are assumed rather than shown. | 4 / 5 |
Workflow Clarity | Five clearly sequenced steps with explicit fallback checkpoints ("If no config is present, continue against the default Basic Memory project and mention that setup has not been run"; "if the repository is missing, report that setup is incomplete"). As a read-only skill it needs no destructive-operation validation, but there is no final verification of the summary before presenting, matching the 4 rather than 5 anchor. | 4 / 5 |
Progressive Disclosure | No bundle directories (references/, scripts/, assets/) exist and the body references no external files; at roughly 45 lines with well-organized sections (intro, Steps, output spec), this is the self-contained under-50-line case the guidelines say can score 5 on well-organized sections alone. | 5 / 5 |
Total | 17 / 20 Passed |