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

86%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 exemplar of token efficiency for an instruction-only skill: every step is concrete with exact config paths, keys, and frontmatter fields, and the scoping guard plus permalink confirmation give the workflow genuine checkpoints. The only soft spot is that the note-writing mechanics and format are delegated to the bm-writing skill without an inline fallback, leaving minor gaps if that skill is unavailable.

Suggestions

Add a one-line fallback for the case where neither user nor project basic-memory.json exists (e.g., default to codex/decisions or ask the user).

Include a minimal example of the decision note's frontmatter/body shape inline so the step is executable even if the bm-writing skill is not loaded.

Name the tool or command used to write the note and retrieve the permalink (e.g., the Basic Memory CLI invocation) to close the remaining actionability gap.

DimensionReasoningScore

Conciseness

The 38-line body is lean with zero padding: no concept explanations, no library background. "A decision is a choice with rationale and consequences, not a casual preference" is a scoping disambiguation that earns its tokens by excluding casual preferences. Every line is actionable instruction, matching anchor 5.

5 / 5

Actionability

Concrete, executable guidance throughout: exact config paths ("~/.codex/basic-memory.json", project ".codex/basic-memory.json"), specific keys ("primaryProject", "placementConventions"), a fallback directory ("codex/decisions"), and explicit frontmatter fields ("type: decision", "status", "decided", "project"). Anchor 4 rather than 5 because the actual write mechanism and a concrete note-format example are delegated to the bm-writing skill rather than shown, and the include list (step 4) is a checklist rather than copy-paste-ready content.

4 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced (resolve config, clarify, write, include, confirm) with a scoping guard ("Clarify only if the choice itself is ambiguous") and a confirmation checkpoint ("Confirm with the permalink") plus supersedes handling. This is not a destructive or batch operation, so the workflow cap at 3 does not apply. Anchor 4 rather than 5 because there is no explicit error-recovery or validation loop (e.g., what to do if config resolution finds neither file).

4 / 5

Progressive Disclosure

Per the rubric's scoring notes, a skill under 50 lines with no need for external references can score 5 with well-organized sections alone. The body is well-structured (intro trigger, ## Steps), and the one cross-reference ("Apply the bm-writing skill") is clearly signaled and one level deep. No bundle reference files exist to misroute, and no content that belongs in a separate file is inlined.

5 / 5

Total

18

/

20

Passed

Description

58%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 is specific, third-person, and concise, clearly communicating what the skill captures and in which system. Its main weakness is the complete absence of trigger guidance — there is no "Use when..." clause and no synonyms like "record" or "ADR" — which caps completeness and lowers natural trigger coverage.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user makes or asks to record an engineering decision, mentions an ADR, or wants a choice documented."

Include natural synonyms users would say ("record", "document", "log a decision", "ADR") to broaden trigger-term coverage.

Consider naming the resulting artifact or workflow actions (e.g., supersedes linking) to further sharpen distinctiveness from sibling bm-* skills.

DimensionReasoningScore

Specificity

"Capture a durable engineering decision in Basic Memory with rationale, alternatives, consequences, and affected work" names a concrete domain and enumerates specific captured elements, matching anchor 4 (several specifics, minor gaps). Not 5 because it uses a single verb ("capture") with no workflow actions like update or link; not 3 because the enumerated fields make coverage more than 1-2 generic actions.

4 / 5

Completeness

The "what" is clear and concrete (capture a decision in Basic Memory with rationale, alternatives, consequences, affected work), but "when" is entirely absent. Per the judging guidelines, a missing "Use when..." clause or equivalent explicit trigger guidance caps completeness at 3.

3 / 5

Trigger Term Quality

"decision", "rationale", and "alternatives" are natural keywords, but there is no "Use when..." phrasing and common variations users say are missing ("record this decision", "document the decision", "ADR"). This matches anchor 3 (some relevant keywords, missing common variations or synonyms) rather than 4, where only a few natural terms would be absent.

3 / 5

Distinctiveness Conflict Risk

"durable engineering decision in Basic Memory" carves a clear niche with low conflict risk against generic skills, but the absence of explicit triggers leaves minor overlap risk with sibling Basic Memory skills (e.g., bm-writing or other note-capture skills). Anchor 4 fits; anchor 5's "distinct triggers" is not met without a when-clause.

4 / 5

Total

14

/

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.