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.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

A high-quality, operationally precise setup skill: every step carries exact tool calls, commands, or JSON, and validation/feedback checkpoints guard the risky write steps. Its only real weaknesses are moderate length with some repetition in the cloud/teams section and a monolithic single-file layout that could offload some detail to reference files.

DimensionReasoningScore

Conciseness

The ~270-line body is dense with non-obvious operational specifics (exact bm_* tool calls, CLI flags, the '[object Object]' cloud-write gotcha, the uv --prerelease pitfall) and rarely explains concepts Claude already knows, which fits the 'efficient with minor trimming possible' anchor. It is not the lean top anchor: step 3 repeats "bm_project(command=\"list\")" three times, the prerequisite re-check restates the earlier instruction, and a few rationale asides (e.g. "notes work fine without it and structure can stay emergent") could be tightened.

4 / 5

Actionability

Guidance is copy-paste ready throughout: concrete tool invocations ("bm_project(command=\"create\", name=\"<name>\", path=\"<path>\")"), a complete settings JSON block, executable commands ("git ls-files skills/ | grep -q memory-", "npx skills add basicmachines-co/basic-memory/skills -g"), and exact smoke-test queries with flags. Specific examples cover the common cases (coding vs general profile, local vs cloud project), matching the fully-executable top anchor.

5 / 5

Workflow Clarity

The sequence is explicit — Prerequisite check → 8-item Interview → confirmed plan → Apply (seed schemas, install skills, write settings, smoke-test) → Close — with validation checkpoints and error-recovery loops at every risky step: "don't start the interview until it succeeds", "If it exists, skip it — never overwrite", verify with "bm_read(..., output_format=\"json\", include_frontmatter=true)", and "If a query errors ... surface it and fix the project ref before closing". This matches the anchor for clear sequencing with explicit validation and feedback loops; it exceeds the 4-anchor because checkpoints are stated, not merely implied.

5 / 5

Progressive Disclosure

The body is well-sectioned (## headers, numbered interview and apply steps) and pushes its detail appropriately to clearly-signaled, one-level-deep external files — the plugin's seed schemas ("<plugin>/schemas/", coding-session.md, session.md, decision.md, task.md) and "[skills/README.md](../../../../skills/README.md)" — with no nested reference chains. It falls short of the top anchor because everything else is inlined in a single long SKILL.md with no bundle reference files: the cloud-routing nuances and the full settings-key semantics could arguably live in a reference file.

4 / 5

Total

18

/

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.

A strong description: it states what the skill does through four concrete actions and gives an explicit, multi-phrase 'Use when...' trigger clause including the exact slash command. Third-person voice is used throughout, and the only weakness is a handful of missing natural trigger variations (e.g. "install basic memory").

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes" — delivered via "a short guided interview", covering the skill's capabilities comprehensively. This matches the anchor for multiple specific concrete actions; it is above the 'several specific actions with minor gaps' anchor because no core capability of the setup flow is omitted.

5 / 5

Completeness

It explicitly answers both parts: 'what' ("a short guided interview that configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes") 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. This is a direct match for the top anchor; it is not the 4-anchor because the 'when' clause is explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Triggers include the exact slash command "/basic-memory:bm-setup", the natural quoted phrase "set up basic memory", and the verb variants "configure/bootstrap the plugin" — good, naturally-spoken coverage. It falls short of the comprehensive anchor because a few natural variations are missing (e.g. "install basic memory", "basic memory setup", "bm-setup" without the plugin prefix).

4 / 5

Distinctiveness Conflict Risk

The description is pinned to a named product ("the Basic Memory plugin") with plugin-specific triggers (the /basic-memory:bm-setup command, "set up basic memory"), giving it a clear niche with minimal conflict risk against other skills. It is not the 4-anchor since the triggers name the plugin explicitly rather than leaving minor overlap with closely related skills.

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.