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

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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 detailed, highly actionable setup workflow with strong sequencing and explicit validation/feedback loops. It is mostly token-efficient and well-structured, with only minor conciseness trimming and progressive-disclosure splitting opportunities.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and assumes competence, but includes some rationale prose ('Don't let it evaporate', 'without it, placement is guesswork') that could be trimmed without losing the actionable guidance.	4 / 5
Actionability	Provides fully executable guidance: concrete commands (uv tool install, claude mcp add, npx skills add, git ls-files), specific MCP tool calls with parameters (write_note with directory/note_type/metadata), and a complete settings JSON block.	5 / 5
Workflow Clarity	Clear sequence (Prerequisite check → 8-step Interview → 4-step Apply → Close) with explicit validation checkpoints: re-check list_memory_projects, a smoke-test section proving recall resolves, and a feedback loop to fix misrouting before closing.	5 / 5
Progressive Disclosure	Well-organized into clear sections with signaled references to external files (coding-session.md, session.md, skills/README.md), though no bundle files exist and a fair amount of detailed operational guidance is inlined in this single ~270-line 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, concrete description that names specific actions and provides explicit, natural-language trigger guidance including the slash command. Only minor room for improvement in covering additional synonymous phrasings.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes' — giving comprehensive coverage of what the interview does.	5 / 5
Completeness	Explicitly answers both what (a guided interview performing the listed actions) 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 triggers.	5 / 5
Trigger Term Quality	Includes natural trigger phrases ('set up basic memory', 'configure/bootstrap the plugin') plus the slash command, but lacks a few common synonyms or phrasings a user might naturally say.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche — Basic Memory plugin setup — with a distinct slash command and specific phrasing, minimizing overlap with unrelated skills.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 328f898

Reviewed: ~7 hours ago

Table of Contents

Discovery Implementation Validation

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.