CtrlK
BlogDocsLog inGet started
Tessl Logo

bm-remember

Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.

64

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./plugins/codex/skills/bm-remember/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%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 an exemplary simple-skill instruction: lean, fully parameterized, and unambiguous, with clear boundary guidance against bm-decide and bm-checkpoint. Its only real weaknesses live in the frontmatter description, not the content.

DimensionReasoningScore

Conciseness

The ~35-line body is lean and operational with zero padding: no concept explanations, no filler, and every line earns its place (config defaults, parameter specs, boundary rules). This matches the anchor-5 example of lean, efficient content that assumes Claude's competence.

5 / 5

Actionability

Fully concrete guidance: exact config paths with defaults (`rememberFolder`, default `codex/remember`), a complete write_note parameter spec (title trimmed to 80 characters, tags ["codex", "manual-capture"], routing to primaryProject), and an explicit rule for preserving user wording. For an instruction-only skill this is copy-paste-ready, matching anchor 5 rather than 4 (no gaps in the common case).

5 / 5

Workflow Clarity

The 4-step sequence is unambiguous with a built-in clarification checkpoint ("ask one short question" when the referent is unclear) and a confirmation step returning the permalink. The operation is a single low-risk write, not destructive or batch, so the validation cap does not apply, and the simple-skill exception holds. Not 4 — there are no minor checkpoint gaps.

5 / 5

Progressive Disclosure

Under 50 lines, single task, no external bundle files needed; sections are well-organized (intro, Steps, boundary note) and the one cross-skill reference (bm-writing) is clearly signaled and one level deep. Per the rubric's simple-skill guideline this scores 5.

5 / 5

Total

20

/

20

Passed

Description

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

The description has a clear, concrete "what" and good boundary definition against sibling skills, but it lacks any "Use when..." trigger guidance, which caps completeness and leaves common trigger phrases users would actually say ("note this", "don't forget") out of the description.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user says 'remember that', 'note this', 'save this', or shares a small fact or preference that should persist."

Include common trigger variations and synonyms ("keep this", "don't forget") in the description so users' natural phrasings match without relying on the body text.

Optionally name the concrete downstream action (writing a note via write_note into the remember folder) to lift specificity beyond 1-2 stated actions.

DimensionReasoningScore

Specificity

"save a small fact, reminder, or user preference into Basic Memory" names the domain and 1-2 concrete actions, but coverage is not comprehensive — the note-writing action and output are absent. It sits at anchor 3, below 4 (which requires several listed actions) and above 2 (actions are concrete, not generic).

3 / 5

Completeness

The description has a clear "what" (save a small fact/preference into Basic Memory) but no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the rubric guideline.

3 / 5

Trigger Term Quality

"remember", "save", "reminder", and "preference" are natural user terms, but common variations users would say ("note this", "don't forget", "keep this") are missing from the description. This matches anchor 3 rather than 4, where only a few natural terms would be missing.

3 / 5

Distinctiveness Conflict Risk

"without turning it into a full decision or checkpoint" explicitly delineates the niche against sibling skills (bm-decide, bm-checkpoint). Triggers like "save this" could still overlap with other memory-capture skills, so it is mostly distinct with minor overlap risk (anchor 4) rather than a clear niche with minimal conflict (anchor 5).

4 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.