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 content is a tight, well-structured, actionable workflow that respects token budget and delegates appropriately. The main gap is the absence of a worked example note and an explicit write/persist command, which would make the guidance fully copy-paste ready.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: it gives exact config paths, exact field values, and a one-line distinction ('a decision is a choice with rationale and consequences, not a casual preference') with no padding and no explanation of concepts Claude already knows.

5 / 5

Actionability

Concrete, executable guidance is present throughout — exact paths (~/.codex/basic-memory.json), exact fields (type: decision, status: open, decided: <ISO timestamp>), and precise placement rules — but there is no example note body and no exact write command, leaving minor gaps.

4 / 5

Workflow Clarity

A clear five-step numbered sequence ends with a confirmation step ('Confirm with the permalink') that acts as a checkpoint, and the supersedes/link handling provides a feedback path; this is not a destructive or batch operation so no cap applies, though there is no explicit validation that the write persisted beyond the permalink check.

4 / 5

Progressive Disclosure

For a single-purpose skill well under 50 lines with no need for external reference files, the body is cleanly organized into an intro plus a numbered Steps section with sub-bullets, and it cleanly delegates detail to the bm-writing skill rather than nesting references.

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 and distinct, clearly conveying what the skill captures, but it lacks an explicit 'when to use' trigger clause and leans on specialist vocabulary over natural user phrasing. Adding a concrete 'Use when the user records or asks to log an engineering decision...' clause would lift completeness and trigger quality.

Suggestions

Add an explicit 'Use when...' clause naming natural trigger phrases users would say, e.g. 'Use when the user records, logs, or asks to document an engineering decision or design choice.'

Soften specialist vocabulary by including common synonyms users actually say ('record a decision', 'log a decision', 'design choice', 'ADR') alongside 'durable engineering decision'.

Clarify the trigger boundary versus generic note-taking skills by stating what is NOT a decision (e.g., 'not a casual preference').

DimensionReasoningScore

Specificity

Names the domain ('Capture a durable engineering decision in Basic Memory') and lists several concrete content elements (rationale, alternatives, consequences, affected work), but 'capture' is a single verb and the listed items are captured fields rather than distinct actions, leaving minor coverage gaps versus a multi-action example.

4 / 5

Completeness

The 'what' is clearly stated (capture a decision with these fields), but there is no explicit 'Use when...' clause or equivalent trigger guidance, so per the rubric guideline completeness is capped at 3 with the 'when' only weakly implied.

3 / 5

Trigger Term Quality

Domain-accurate terms ('decision', 'Basic Memory', 'rationale', 'alternatives', 'consequences') are present but lean toward specialist vocabulary rather than the natural phrases a user would say ('record a decision', 'log a decision'), and common variations or synonyms are missing.

3 / 5

Distinctiveness Conflict Risk

The 'durable engineering decision in Basic Memory' framing carves a narrow, distinct niche with low conflict risk against generic note skills, though the absence of explicit trigger phrasing leaves minor overlap risk with related note/recording skills rather than fully sealing it.

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.

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.