Content
88%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 an excellent, fully executable diagnostic procedure: exact commands, precise MCP query parameters, a literal output template, and explicit fallbacks for unavailable components. Its only minor weaknesses are a slightly wordy config-precedence paragraph and its length relative to the simple-skill threshold.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and instructional throughout — "This is a quick diagnostic — gather the facts and lay it out; don't over-investigate" — with no concept explanations or padding, assuming Claude's competence. Anchor 4 rather than 5 only because the config-precedence paragraph ("do not trim it, expand `~`, or treat an empty value as unset") is slightly wordier than strictly necessary. | 4 / 5 |
Actionability | Everything is copy-paste ready: exact commands (`basic-memory --version`, `uvx --prerelease=allow basic-memory --version`, `basic-memory hook status --harness claude --project-dir <project-root>`), fully parameterized `search_notes` calls with `metadata_filters` and `page_size`, and a literal output template. Anchor 5 — concrete commands cover the common cases, including the coding-profile variant. | 5 / 5 |
Workflow Clarity | A clear five-step Gather sequence flows into a Present template, with explicit error-recovery fallbacks ("If no launcher resolves... mark these fields unavailable and continue", "write '—'... rather than failing the whole report") and a canonical-vs-merged config mismatch check. Anchor 5; the read-only diagnostic nature means the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist and the skill is a single cohesive self-contained procedure with clean `## Gather` / `## Present` sections and an integral output template — nothing is misfiled or buried. Anchor 4 rather than 5 because at ~93 lines it exceeds the under-50-line simple-skill case where sections alone would suffice. | 4 / 5 |
Total | 18 / 20 Passed |