CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-doctor

Check local Basic Memory projects with bm doctor, explain the findings, and run the suggested fixes once the user agrees. Use when search misses or repeats notes, or a save looks lost.

Quality

91%

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

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

An exemplary instruction-only skill body: executable commands, a complete report schema, a severity-to-action table, and a fix workflow with consent and verification checkpoints. The only gaps are a missing explicit recovery branch when findings persist after a fix, and a body size just past what comfortably fits the single-file ideal.

Suggestions

Add one line to the Fix workflow for the failure case, e.g., "If findings remain after re-running, report the leftover evidence to the user instead of re-running fixes unprompted," to close the validation feedback loop.

If the skill grows further, move the full report JSON example into a reference file and keep only the key fields inline in SKILL.md.

DimensionReasoningScore

Conciseness

Every section conveys bm-specific knowledge Claude cannot already have — severity semantics ("error | Will not go away without a fix"), background indexing behavior, cloud-project limitations, exit codes — with no padding or explanation of known concepts. This matches the 5 anchor: lean, assumes competence, every token earns its place.

5 / 5

Actionability

Commands are copy-paste ready ("bm doctor --skip-self-test --json", "--project NAME"), the report's stable JSON shape is shown in full for parsing, and the severity table maps each level to a concrete action ("Offer the `command`; if it is null, explain the evidence"). This fully matches the 5 anchor.

5 / 5

Workflow Clarity

The Fix section is a clearly sequenced four-step process — summarize findings, show commands and ask before running, run approved commands, then "Run bm doctor ... again and confirm the findings are gone" — with an explicit user-consent checkpoint and a final validation step. Not 5 because there is no explicit error-recovery branch for what to do when findings persist after the fix, which the 5 anchor expects as a feedback loop.

4 / 5

Progressive Disclosure

The body is a single well-organized file with clear sections (When to Use, Run It, Read the Report, Fix, Exit Codes), no bundle files exist, and no content clearly belongs in a separate reference. Not 5 because the ~88-line body exceeds the under-50-line simple-skill exception, and the 20-line report JSON example is the kind of detail that could live in a reference file if the skill grew.

4 / 5

Total

18

/

20

Passed

Description

88%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 three-action scope, an explicit Use-when trigger clause with natural symptom phrasing, and a distinct niche anchored to a named tool. The only weaknesses are missing synonyms in the trigger terms and slight generic overlap risk in the symptom-based triggers.

Suggestions

Add one or two common symptom synonyms to the trigger clause (e.g., "duplicate notes" or "a note can't be found") to broaden natural-trigger coverage.

Tie the trigger clause more tightly to the tool (e.g., "Use when Basic Memory search misses or repeats notes...") to reduce overlap with generic search/save complaints.

DimensionReasoningScore

Specificity

The description lists three concrete actions covering the skill's full workflow — "Check local Basic Memory projects with bm doctor", "explain the findings", and "run the suggested fixes once the user agrees" — with no coverage gaps within the skill's scope. It fits the 5 anchor (multiple specific concrete actions, comprehensive) better than 4, which would require minor gaps.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is the three named actions, and the "when" is an explicit "Use when" clause with three concrete trigger symptoms. This matches the 5 anchor's pattern of a clear what plus explicit trigger phrases.

5 / 5

Trigger Term Quality

"Use when search misses or repeats notes, or a save looks lost" uses natural symptom phrases a user would actually say, plus the distinctive terms "bm doctor" and "Basic Memory". Not 5 because common synonyms are missing (e.g., "duplicate note", "can't find a note", "index out of sync"); not 3 because the natural phrasing present goes beyond bare domain keywords.

4 / 5

Distinctiveness Conflict Risk

"Check local Basic Memory projects with bm doctor" carves out a clear niche with a named tool, so conflict risk is low. Not 5 because the trigger clause alone ("a save looks lost", "search misses") could fire on generic save/search complaints unrelated to Basic Memory — minor overlap risk matching the 4 anchor.

4 / 5

Total

18

/

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

Path

skills/memory-doctor/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.