Content
81%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 a strong, dense instruction set: it provides exact commands, tool calls, and a complete settings template, and sequences an adaptive interview into a validated apply-and-verify workflow with real error-recovery loops. It stays lean by carrying only plugin-specific gotchas rather than general knowledge; the main improvement opportunities are tightening a few long passages and replacing the '…' smoke-test command placeholder with fully spelled-out invocations.
Suggestions
Replace the '… tool search-notes --type schema --page-size 10' placeholder in the smoke-test section with one or two fully written example invocations (e.g. 'basic-memory tool search-notes --project <ref> --type schema --page-size 10') so the verification step is copy-paste ready.
Tighten the cloud-routing detail in interview step 2 and the schema-seeding metadata bullet — both state the same local-vs-cloud server constraint more than once — to recover tokens without losing the gotchas.
Consider moving the long schema-seeding mechanics (write_note parameter details and the cloud '[object Object]' corruption note) into a short reference file in the skill bundle, keeping the interview flow inline and the low-level write details one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every sentence carries plugin-specific, non-inferable facts (the --prerelease=allow uv gotcha, cloud-vs-local server routing, the '[object Object]' cloud-write corruption bug, the 6-project brief cap) with no padding about concepts Claude already knows. A few passages — the cloud routing detail in interview step 2 and parts of the smoke-test section — repeat or run long and could be trimmed, so it is efficient-with-minor-excess rather than the lean 5 anchor. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact install/connect commands (uv tool install basic-memory --prerelease=allow; claude mcp add basic-memory -- uvx ...), the clobbering guard (git ls-files skills/ | grep -q memory-), npx skills add basicmachines-co/basic-memory/skills -g, a complete settings JSON block, and exact write_note parameters. Minor gaps keep it below 5: the smoke-test command is shown with a literal '… tool search-notes' placeholder rather than a copy-paste-ready invocation, and the seed-schema paths are described relative to <plugin> instead of resolved absolutely. | 4 / 5 |
Workflow Clarity | A clear, well-sequenced workflow (Prerequisite check → 8-item Interview → confirmed Apply with 4 numbered sub-steps → Close) with explicit validation checkpoints and feedback loops: re-check list_memory_projects before starting, no writes until the plan is confirmed, skip existing schemas rather than overwrite, verify seeded notes via read_note(..., output_format="json"), and the smoke-test with 'If a query errors, or the primary returns nothing, surface it and fix the project ref before closing.' This matches the top anchor including error-recovery loops. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the body is well-sectioned (Prerequisite / Interview / Apply / Close) with clearly signaled, one-level-deep external reads (seed schemas at <plugin>/schemas/, manual install in skills/README.md). At ~270 lines, detail blocks such as the schema-seeding cloud gotchas or cloud project routing could arguably live in reference files, which keeps it at the 'good structure, minor organization gaps' anchor rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |