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

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

77%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, highly actionable setup runbook with strong workflow sequencing and validation checkpoints, but it carries all of its considerable detail inline in one file with no progressive disclosure into bundle references, and several passages are more verbose than they need to be.

Suggestions

Tighten the verbose parenthetical asides and reduce overlap between the Interview section and the Apply section (e.g. the cloud-routing and coding-profile details are restated) to lift conciseness.

Factor the detailed schema-seeding parameter spec and the coding-profile Git-identity requirements into a reference file (e.g. references/schema-seeding.md) linked from the Apply section, so SKILL.md stays an overview.

Move the per-step interview scripts/sample prompts into a separate reference so the main body reads as a concise flow rather than inline transcripts.

Dimension	Reasoning	Score
Conciseness	The ~274-line body assumes Claude's competence (no concept padding) and most detail is load-bearing for a genuinely complex setup, but verbose parenthetical asides and some repetition between the Interview and Apply sections could be tightened. Not a 3 because not every token earns its place; not a 1 because it avoids explaining things Claude already knows.	2 / 3
Actionability	Fully executable guidance throughout: concrete install/connect commands, exact write_note parameters, a copy-paste JSON settings block, and specific smoke-test CLI invocations (e.g. 'git ls-files skills/ \| grep -q memory-', 'npx skills add basicmachines-co/basic-memory/skills').	3 / 3
Workflow Clarity	A clear sequence (Prerequisite check → 8-step Interview → 4-step Apply → Smoke-test → Close) with explicit validation checkpoints ('Re-check list_memory_projects before continuing') and an error-recovery feedback loop ('If a query errors, or the primary returns nothing, surface it and fix the project ref before closing').	3 / 3
Progressive Disclosure	Well-organized into clear sections, but the skill is a single monolithic ~274-line file with no bundle files or one-level-deep references; detailed content that could be split (schema-seeding parameter specs, coding-profile Git-identity fields) is inline rather than factored into reference files.	2 / 3
	Total	10 / 12 Passed

Description

100%Weight 40%Scale 1-3

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 well-triggered: it names concrete capabilities, gives explicit 'Use when' triggers with natural phrasings, and is clearly distinct from other skills. Third-person imperative voice is used correctly with no first/second-person slip.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes' — rather than vague language.	3 / 3
Completeness	Explicitly answers both what (a guided interview that configures mapping, schemas, placement, capture) and when ('Use when the user runs /basic-memory:bm-setup, says "set up basic memory", or asks to configure/bootstrap the plugin').	3 / 3
Trigger Term Quality	Covers natural phrasings a user would actually say: the slash command '/basic-memory:bm-setup', 'set up basic memory', and 'configure/bootstrap the plugin'.	3 / 3
Distinctiveness Conflict Risk	A clearly bounded niche (Basic Memory plugin setup) anchored by a specific slash-command trigger, making it unlikely to fire for unrelated skills.	3 / 3
	Total	12 / 12 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: 60408ad

Reviewed: 11 days 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.