CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bm-remember

Quickly capture a thought, fact, or reminder into Basic Memory as a lightweight note. Use when the user says "remember that…", "note this", "save this to memory", or runs /basic-memory:bm-remember. For quick deliberate capture — not full decision or session records.

Quality

84%

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

78%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 tight, operational runbook: exact config-resolution rules, concrete MCP tool parameters, and a well-sequenced workflow with sensible guardrails for a lightweight capture. It is uniformly strong, with only minor headroom — a populated example call and a write-failure path would close the last gaps.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — it spends its tokens on non-obvious operational rules (config precedence edge cases like "do not trim it, expand ~, or treat an empty value as unset", title truncation to ≤ 80 chars, default folder "bm-remember") rather than explaining concepts. A couple of parentheticals ("e.g. you were invoked because the user said 'remember that…'") could be trimmed, keeping it just below anchor 5.

4 / 5

Actionability

Concrete, executable guidance: named tool calls (bm_project(command="list"), bm_write) with exact parameter mapping (tags = ["manual-capture"], directory = resolved rememberFolder, project routing including external_id UUIDs) and explicit defaults. It falls short of anchor 5 only because no fully-populated example bm_write call is shown.

4 / 5

Workflow Clarity

A clear four-step sequence (Resolve config → Derive note → Write → Confirm) with meaningful checkpoints: the ask-one-question fallback when $ARGUMENTS is empty, the guard "Don't overwrite an existing note unless the user explicitly asks", and a one-line confirmation with permalink. Minor gap: no error-recovery path if the write itself fails, so it does not reach anchor 5.

4 / 5

Progressive Disclosure

A self-contained, single-task skill (~55 compact lines) with well-organized Steps/Notes sections, no bundle files to disclose, and appropriate one-level pointers to sibling skills (bm-writing, bm-decide, bm-checkpoint) instead of inlining their content. Navigation is easy and nothing that belongs elsewhere is inlined.

5 / 5

Total

17

/

20

Passed

Description

83%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: concrete single-action capability, explicit 'Use when…' triggers quoted as natural user utterances, and clear boundary language separating it from heavier-weight sibling skills. The only softness is that a couple of common trigger variants are absent and 'save this to memory' could collide with generic memory features.

DimensionReasoningScore

Specificity

"Quickly capture a thought, fact, or reminder into Basic Memory as a lightweight note" names a fully qualified concrete action with destination, note type, and an explicit scope boundary ("not full decision or session records"). It sits above anchor 3 because the single action is completely specified for a single-purpose skill, but below anchor 5 since it does not list several distinct actions.

4 / 5

Completeness

Explicitly answers both what ("capture a thought, fact, or reminder into Basic Memory as a lightweight note") and when ("Use when the user says 'remember that…', 'note this', 'save this to memory'") with concrete trigger phrases, matching the anchor-5 pattern.

5 / 5

Trigger Term Quality

Quotes natural user utterances — "remember that…", "note this", "save this to memory" — plus the command "/basic-memory:bm-remember", which is exactly how a user would invoke this. A few common variants (e.g. "don't forget this", "keep this") are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The clause "For quick deliberate capture — not full decision or session records" explicitly disambiguates sibling skills, and the Basic Memory niche is distinct. Minor overlap risk remains because "save this to memory" is a phrase users could also intend for a built-in memory feature.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

basicmachines-co/basic-memory

Path

plugins/claude-code/skills/bm-remember/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.