CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

71

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

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

An exceptionally actionable, well-sequenced setup skill with real validation feedback loops and hard-won operational caveats preserved. Its weakness is structural: everything lives inline in SKILL.md, so the progressive-disclosure and token-budget dimensions trail the execution-focused ones.

Suggestions

Move the stable detail (cloud routing rules, the schema-seeding procedure with its metadata/content pitfalls, and the smoke-test command catalogue) into a references/ file and keep SKILL.md as the interview + apply overview — this would lift both progressive_disclosure and conciseness.

Trim the scripted interview dialogues to the questions themselves plus defaults; the rationale paragraphs (e.g. why placementConventions matters, what captureEvents records) can move to the reference file.

Consider extracting the coding-profile rules (repository resolution, Git identity requirements) into their own reference so the general-profile path stays short for non-coding users.

DimensionReasoningScore

Conciseness

The body is long (~270 lines) but nearly every line carries non-obvious operational detail Claude could not infer — the '--prerelease=allow' uv pinning rationale, workspace-qualified project names, the cloud '[object Object]' frontmatter corruption bug, and the source-checkout clobber guard. Minor over-explanation in the scripted interview questions and the step-1 rationale keeps it at the 'efficient; minor instances could be trimmed' anchor rather than the lean level 5.

4 / 5

Actionability

Guidance is fully executable: exact MCP tool calls with parameters ('create_memory_project', 'write_note' with directory/note_type/metadata), copy-paste commands ('uv tool install basic-memory --prerelease=allow', 'npx skills add basicmachines-co/basic-memory/skills', the 'git ls-files skills/ | grep -q memory-' guard), a complete JSON settings block, and a concrete smoke-test procedure. This matches the 'copy-paste ready' level 5 anchor.

5 / 5

Workflow Clarity

The sequence is explicit — prerequisite check, interview, apply (seed schemas → install skills → write settings → smoke-test), close — with validation checkpoints and feedback loops throughout: re-check 'list_memory_projects' before proceeding, skip existing schemas to avoid overwrites, verify seeded notes with 'read_note(..., output_format="json")', and 'if a query errors... surface it and fix the project ref before closing'. This matches the level 5 anchor (explicit validation, error recovery).

5 / 5

Progressive Disclosure

Section structure is clear, but the skill is a ~270-line single file with no bundle references — detailed material that plausibly belongs in reference files (cloud routing rules, the schema-seeding procedure, interview question scripts) is inlined. It sits above the 'references buried / minimal structure' level 2 anchor but only at 'some structure; content that should be separate is inline' (level 3).

3 / 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.

A strong description: third-person, concrete about both capability and triggers, with a namespaced command that eliminates conflict risk. The only gap is modest keyword coverage beyond the core phrases.

DimensionReasoningScore

Specificity

The description lists four concrete actions — 'configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes' — giving comprehensive coverage of the setup flow. It is well above the 'several specific actions, minor gaps' level 4 anchor because every phase of the task is named.

5 / 5

Completeness

It explicitly answers both what ('a short guided interview that configures the project mapping, seeds note schemas...') 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, matching the level 5 anchor exactly. It is not level 4 because the 'when' clause is already maximally explicit.

5 / 5

Trigger Term Quality

Triggers include the exact slash command ('/basic-memory:bm-setup'), a natural user phrase ('set up basic memory'), and verb synonyms ('configure/bootstrap'). A few natural variants users might say ('install basic memory', 'initialize') are missing, so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the fully comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (the Basic Memory plugin) with a namespaced slash command and plugin-specific trigger phrases, so overlap with other skills is minimal — matching the 'clear niche with distinct triggers' anchor. It does not fall to level 4 because no closely related skill would claim these triggers.

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