CtrlK
BlogDocsLog inGet started
Tessl Logo

memory-lifecycle

Manage entity status transitions in Basic Memory: archive completed work, move notes between status folders, update frontmatter, and handle edge cases. Use when marking items complete, archiving old entities, or managing any folder-based status workflow.

72

Quality

88%

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.

A well-crafted, dense skill: executable code throughout, an explicit validation-checked workflow, and disciplined brevity that teaches only non-obvious domain specifics (permalink behavior, frontmatter-only edits). Minor gains available from consolidating the repetitive folder-structure examples and trimming the generalized patterns.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no space is spent explaining what Basic Memory or frontmatter is, and code examples carry the instruction weight. The folder-conventions section illustrates three overlapping structures (entities/, tasks/, [type]/) where one example plus the generalization would do, a minor instance of over-explanation — anchor 4's "efficient; minor instances of over-explanation that could be trimmed". Not anchor 5 because of that repetition; clearly above anchor 3's "some unnecessary explanation".

4 / 5

Actionability

Every operation is shown as copy-paste-ready code with realistic parameters — search_notes(query=...), move_note(identifier=..., destination_path=...), edit_note(operation="append", content="", metadata={...}) — plus a concrete signals-to-action table and revert examples covering the common cases. This matches anchor 5's "fully executable; copy-paste ready code or commands; specific examples cover the common cases".

5 / 5

Workflow Clarity

The four-step workflow (find → move → update frontmatter → confirm) has explicit validation checkpoints: "If multiple matches come back, present options and ask which one", "If no match is found, ask for clarification — don't guess", already-archived detection, and a confirm-before-batch rule ("find them all, confirm the list, then move them in sequence") for batch operations. Error recovery is addressed via the revert/reactivate section. This matches anchor 5's "clear sequence with explicit validation steps; feedback loops for error recovery". The core operation is archival (non-destructive), and the one destructive action (delete) is explicitly guarded.

5 / 5

Progressive Disclosure

The skill has no bundle files, so structure is judged on the single SKILL.md: well-organized sections with clear headers and a cross-reference section pointing to sibling skills (memory-tasks, memory-notes, memory-defrag), which is appropriate one-level navigation. At ~170 lines it exceeds the under-50-line simple-skill case, and some content (the status-signal table, folder conventions, edge cases) could arguably live in reference files, keeping it at anchor 4's "good structure; most content is appropriately placed" rather than 5.

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 multi-action capability statement with an explicit 'Use when...' trigger clause and a clearly scoped domain. Trigger coverage would reach the top anchor with a few more natural user synonyms (e.g., 'done', 'finished', 'cancelled').

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "archive completed work, move notes between status folders, update frontmatter, and handle edge cases" — mirroring the anchor's "multiple specific concrete actions; comprehensive coverage" for its domain. "Handle edge cases" is slightly generic, but the action list is comprehensive for status-transition management, matching anchor 5 rather than anchor 4's "minor gaps in coverage".

5 / 5

Completeness

It explicitly answers both: what ("Manage entity status transitions in Basic Memory: archive completed work, move notes... update frontmatter") and when ("Use when marking items complete, archiving old entities, or managing any folder-based status workflow"). This matches anchor 5's "clearly and explicitly answers both what AND when with concrete trigger phrases"; anchor 4 would require a weaker or less specific 'when', which is not the case.

5 / 5

Trigger Term Quality

"Use when marking items complete, archiving old entities, or managing any folder-based status workflow" gives good natural-phrase coverage ("marking items complete", "archiving"), matching anchor 4's "good keyword coverage; a few natural terms missing". It misses common user variations like "done", "finished", or "cancelled" that users would naturally say, so it does not reach anchor 5's synonym-level coverage; it clearly exceeds anchor 3's "missing common variations" is borderline but the included phrases are natural, not merely technical.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a clear niche ("Basic Memory" entity status transitions) with distinct triggers, but "managing any folder-based status workflow" is broad and the skill family (memory-tasks, memory-notes, memory-defrag) covers adjacent operations, creating minor overlap risk with closely related skills — anchor 4. It is more distinct than anchor 3's "could still overlap with similar skills" because the archive/transition trigger set is fairly unique, but not the clean minimal-conflict case of anchor 5.

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