CtrlK
BlogDocsLog inGet started
Tessl Logo

bm-decide

Capture a durable engineering decision in Basic Memory with rationale, alternatives, consequences, and affected work.

62

Quality

72%

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

Fix and improve this skill with Tessl

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

Quality

Content

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

The body is concise and well-sequenced for a simple instruction skill, with clear fields and a confirmation step. Its main gap is actionability: the actual note-persistence mechanism is delegated to the bm-writing skill rather than shown inline.

Suggestions

Add a one-line example of the Basic Memory write command or a minimal decision-note skeleton so the core action is executable without jumping to bm-writing.

Specify the exact note filename/path convention alongside the placement rules so the write target is unambiguous.

Show a short example of the supersedes linking syntax to make step 5 copy-applicable.

DimensionReasoningScore

Conciseness

The body is lean and instruction-dense with no generic concept padding; the single scope-disambiguating line ("A decision is a choice with rationale and consequences, not a casual preference") is short and load-bearing rather than fluff.

3 / 3

Actionability

Concrete config-resolution logic and explicit note fields/sections are given, but the actual Basic Memory write mechanism is absent and delegated entirely to the bm-writing skill, leaving key details incomplete.

2 / 3

Workflow Clarity

A clear five-step sequence with a final permalink confirmation and supersedes-handling step; this is not a destructive/batch operation, so no strict validation gate is required.

3 / 3

Progressive Disclosure

A simple under-50-line skill with well-organized sections and no need for external bundle references, meeting the simple-skills allowance for a top score.

3 / 3

Total

11

/

12

Passed

Description

60%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 about what gets captured but omits an explicit "Use when..." trigger clause, capping completeness and trigger-term quality at 2. Distinctiveness is moderate given the family of Basic Memory skills.

Suggestions

Add an explicit "Use when..." clause, e.g. "Use when the user makes or asks to record a durable engineering decision (e.g. an ADR)."

Include common natural trigger variations such as "ADR", "architecture decision record", or "record a decision".

Differentiate from sibling bm-* skills by foregrounding the decision-note type and status/supersedes semantics.

DimensionReasoningScore

Specificity

Names the domain and lists multiple concrete captured elements — "rationale, alternatives, consequences, and affected work" — matching the score-3 anchor for multiple specific concrete actions.

3 / 3

Completeness

Clearly answers "what" but provides no explicit "when"/"Use when..." trigger guidance, which the guidelines cap at 2.

2 / 3

Trigger Term Quality

Contains relevant keywords ("decision", "rationale", "alternatives") but misses common natural variations such as "ADR" or "record a decision", and lacks an explicit trigger clause.

2 / 3

Distinctiveness Conflict Risk

The Basic Memory decision niche is fairly specific, but it could overlap with sibling bm-* skills and lacks distinct explicit triggers to prevent misfiring.

2 / 3

Total

9

/

12

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.

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