CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-defrag

Defragment a Basic Memory project: split bloated notes, consolidate scattered facts, resolve contradictions, retire stale content. Plans first; deletes only when told. Run weekly or on demand.

Quality

84%

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

88%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 excellent, highly actionable process skill: concrete commands, a complete plan template, and genuine safety validation (checksums, conflict recovery, review gating) around destructive operations. The only real room for improvement is trimming a few explanatory passages and moving the plan-template/contradiction examples toward a leaner overview.

DimensionReasoningScore

Conciseness

The body is dense and operational — concrete commands, a problem/fix table, a plan template, and checksum mechanics — with no explanations of concepts Claude already knows. A few explanatory sentences (the motivational opening, "Two statements that disagree are often both true…") could be trimmed, matching the 4 anchor rather than 5's "every token earns its place".

4 / 5

Actionability

Fully executable guidance: bm_find/bm_project/bm_search calls with real arguments (the <project> placeholder is explicitly defined), a copy-paste plan-note template, per-problem fixes, and precise edit-safety mechanics (expected_checksum, read-as-JSON). Matches the 5 anchor — copy-paste ready commands covering the common cases.

5 / 5

Workflow Clarity

Five clearly sequenced steps with explicit validation for a destructive/batch operation: read each note as JSON and pass expected_checksum, "on a checksum conflict, read again and recheck the plan line", one change at a time, plan/review gating, and a done/skipped/review recording step. This matches the 5 anchor (explicit validation, feedback loop for error recovery, checklist) and clears the destructive-operation cap.

5 / 5

Progressive Disclosure

The body is well-sectioned and navigable, and adjacent detail is appropriately delegated one level deep to sibling skills ("observation syntax, including when a claim holds" → memory-notes; merges → memory-curate) instead of being inlined. At ~140 lines with a full plan template and worked contradiction examples inline, it sits between the 4 and 5 anchors — good structure with minor organization gaps rather than a lean overview with everything appropriately split.

4 / 5

Total

18

/

20

Passed

Description

72%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, specific description with concrete actions and a clear niche, held back by weak trigger coverage. The "when" is reduced to a cadence statement ("Run weekly or on demand") rather than explicit trigger guidance naming the phrases a user would naturally say.

Suggestions

Add a trigger clause naming natural user phrasings, e.g. "Use when asked to clean up, reorganize, tidy, or defrag a project's notes, or when duplicate or contradictory notes pile up."

Include common synonyms such as "clean up", "reorganize", and "tidy" alongside "defragment" so the description matches how users actually phrase the request.

State the split from sibling skills more sharply (e.g. "content and structure only — links, tags, and relations go to memory-curate") to further reduce overlap risk with the memory-* skill family.

DimensionReasoningScore

Specificity

The description lists four concrete actions — "split bloated notes, consolidate scattered facts, resolve contradictions, retire stale content" — plus behavioral constraints ("Plans first; deletes only when told"), comprehensively covering the defrag task. It matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, since there are no meaningful coverage gaps.

5 / 5

Completeness

Both "what" (the four concrete actions) and "when" ("Run weekly or on demand") are explicitly present, but the when lacks concrete trigger phrases a user would say. This matches the 4 anchor (both present, when could be more explicit); it is above 3 because the run cadence is stated rather than implied, and below 5 because no trigger phrases are given.

4 / 5

Trigger Term Quality

Relevant keywords are present ("Defragment", "Basic Memory project", "bloated notes", "scattered facts", "contradictions", "stale content") but the most natural user phrasings — "clean up", "reorganize", "tidy" — are missing. This matches the 3 anchor (some relevant keywords, missing common variations or synonyms) rather than 4.

3 / 5

Distinctiveness Conflict Risk

"Basic Memory project" pins a clear niche with distinct defrag triggers, but closely related sibling skills (memory-curate, memory-reflect) cover adjacent cleanup tasks, creating minor overlap risk. This matches the 4 anchor (mostly distinct, minor overlap with closely related skills) rather than 5.

4 / 5

Total

16

/

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