CtrlK
BlogDocsLog inGet started
Tessl Logo

memory-curate

Curate the Basic Memory knowledge graph: find orphan notes and suggest links, propose typed relations, merge duplicates, audit tags and folders, and build hub notes. Use to organize, connect, and improve a knowledge base as notes accumulate.

65

Quality

78%

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 ./skills/memory-curate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, highly actionable single-file skill with concrete executable examples for every capability and sensible safety practices (confirm before changing, preserve permalinks). The weakest area is workflow clarity: the curation passes lack explicit sequencing and post-change verification loops for batch operations like merges and moves.

Suggestions

Add explicit validation/verification steps after batch operations, e.g. re-run the orphan or duplicate search after applying relations or merging notes to confirm the change had the intended effect, and iterate if not.

Flesh out the Curation Workflows section with a concrete step sequence per pass type (e.g. health check: search -> report -> ask; deep session: orphans -> duplicates -> folders -> tags -> hub) instead of "whatever order the findings suggest".

Consider moving the Example Conversations and the relation-type vocabulary into a small references/ file to keep SKILL.md as a leaner overview.

DimensionReasoningScore

Conciseness

The body is largely efficient — terse code blocks per capability, a compact relation-type vocabulary, and no explanation of concepts Claude already knows. Minor instances could be trimmed (the "islands in the graph" metaphor, the intro paragraph, and some narrative in Example Conversations), fitting anchor 4's "minor instances of over-explanation" rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Every capability ships complete, executable tool calls with realistic parameters — search_notes/read_note inspection, edit_note with operation="insert_after_section" and section/content, move_note with a destination path, and a full write_note hub-note example — plus a concrete relation-type vocabulary and specific decision guidance for duplicates and tags. This matches anchor 5's fully executable, copy-paste-ready guidance covering the common cases.

5 / 5

Workflow Clarity

The Curation Workflows section names three pass types but leaves sequencing implicit ("in whatever order the findings suggest"), and while "Confirm before changing" acts as a pre-flight checkpoint, the batch/destructive operations (merging notes, moves, batch edit_note inserts) lack explicit post-change validation or verify-then-fix loops. Per the judging guideline, batch operations without validation steps cap workflow clarity at 3.

3 / 5

Progressive Disclosure

The single-file bundle is well organized: clear section headers, seven self-contained capability units, and concise workflows and best practices. It is not anchor 5 because the file exceeds the simple-skill threshold and content like the Example Conversations and relation vocabulary could be split into reference files; it is above anchor 3 because nothing is buried or badly inlined, and structure and navigation are good.

4 / 5

Total

16

/

20

Passed

Description

80%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 that clearly and specifically communicates what the skill does with an explicit use clause. The main gaps are the absence of concrete trigger phrases in the when-clause and a few natural synonyms that would help it fire on the phrasings users actually say.

Suggestions

Convert the use clause into explicit trigger guidance, e.g. "Use when the user asks to organize or clean up notes, mentions orphan/unlinked notes or duplicates, or asks what isn't linked".

Add a few natural user phrasings as trigger terms ("clean up my notes", "find related notes", "what's not linked") that currently live only in the body's When to Use section.

Add a brief disambiguation against the sibling memory-defrag skill in the description (e.g. "for memory-file hygiene see memory-defrag") to reduce conflict risk between the two.

DimensionReasoningScore

Specificity

The description lists six concrete actions ("find orphan notes and suggest links, propose typed relations, merge duplicates, audit tags and folders, and build hub notes") with comprehensive coverage of the curation domain, matching the anchor for multiple specific concrete actions. It is not a 4 because no meaningful capability gaps are evident.

5 / 5

Completeness

The "what" is clear and concrete (curate the Basic Memory knowledge graph with the listed actions) and an explicit "Use to organize, connect, and improve a knowledge base as notes accumulate" clause provides the "when". It falls short of anchor 5 because the when-clause states purpose rather than concrete user trigger phrases (e.g. "Use when the user asks to clean up notes or mentions orphans"), and is clearly above anchor 3 where the when is missing or only weakly implied.

4 / 5

Trigger Term Quality

Natural user-sayable terms like "organize", "connect", "knowledge base", "orphan notes", and "merge duplicates" are present, but common variations users would actually say (e.g. "clean up my notes", "find related notes", "what's not linked") appear only in the body's When to Use section, not the description. Good coverage with a few natural terms missing fits anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Curate the Basic Memory knowledge graph" plus niche operations (typed relations, hub notes, orphans) carves a clear niche with distinct triggers. Minor overlap risk remains with closely related memory-management skills — the body explicitly disambiguates against memory-defrag, suggesting adjacent skills exist — but the description itself does not, fitting anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

17

/

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.