CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bm-setup

Set up the Basic Memory plugin for this project — a short guided interview that configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes. Use when the user runs /basic-memory:bm-setup, says "set up basic memory", or asks to configure/bootstrap the plugin.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, complete, and highly distinctive: it names four concrete setup actions, gives an explicit 'Use when' clause with the exact slash command and natural trigger phrases, and is tightly scoped to the Basic Memory plugin. Its only weakness is modest synonym coverage in the trigger terms (e.g., no 'initialize' or 'install' phrasing).

DimensionReasoningScore

Specificity

"configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes" lists four concrete, distinct actions that comprehensively cover the setup flow, matching the top anchor; not 4 because coverage has no notable gaps.

5 / 5

Completeness

Explicitly answers both: "what" (a short guided interview that configures mapping, seeds schemas, sets placement, enables capture) and "when" ("Use when the user runs /basic-memory:bm-setup, says 'set up basic memory', or asks to configure/bootstrap the plugin") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Triggers include the exact slash command (/basic-memory:bm-setup), the natural phrase "set up basic memory", and "configure/bootstrap the plugin" — good natural coverage, but common synonyms like "initialize" or "install basic memory" are missing, so it falls short of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Scoped to a named plugin ("the Basic Memory plugin") with an exact slash command and plugin-specific triggers — a clear niche with distinct triggers and minimal conflict risk with any other skill.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

basicmachines-co/basic-memory

Path

plugins/claude-code/skills/bm-setup/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.