CtrlK
BlogDocsLog inGet started
Tessl Logo

memory-reflect

Sleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory. Use when triggered by cron, heartbeat, or explicit request to reflect on recent activity. Runs as background processing to improve memory quality over time.

67

Quality

80%

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-reflect/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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-organized, mostly lean skill body with concrete guidance and clean structure. The main weakness is the absence of an explicit validation/verification checkpoint in a batch, partially destructive MEMORY.md update workflow.

Suggestions

Add an explicit verification step after updating MEMORY.md (e.g., re-read the file to confirm critical entries survived the merge/restructure and nothing important was dropped) to satisfy the destructive/batch feedback-loop requirement.

Trim or relocate the "Inspired by sleep-time compute" conceptual framing to tighten token efficiency, since Claude does not need the analogy to execute the workflow.

Clarify whether the note API calls (recent_activity, read_note, search_notes) are exact invocations or illustrative pseudocode, and if exact, note their source so the guidance is unambiguously executable.

DimensionReasoningScore

Conciseness

Mostly lean and efficient with concrete code and tight guidelines, but the "Inspired by sleep-time compute" framing line is mild conceptual padding Claude does not need.

4 / 5

Actionability

Provides concrete API calls (recent_activity, read_note, search_notes), explicit keep/skip criteria, and a log template, but the function calls are illustrative rather than fully copy-paste-ready executable code.

4 / 5

Workflow Clarity

The four-step sequence (Gather, Evaluate, Update, Log) is clear, but batch consolidation that removes/updates outdated MEMORY.md entries lacks an explicit validate-and-verify checkpoint, capping this at 3 per the destructive/batch feedback-loop rule.

3 / 5

Progressive Disclosure

A single well-organized file with clear section headers (When to Run, Process, Guidelines), no nested references, and no need for external bundle files, making navigation trivial.

5 / 5

Total

16

/

20

Passed

Description

87%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, well-structured description that clearly states both capability and trigger conditions with concrete actions and a distinct niche. Minor room for improvement in keyword synonym coverage and action specificity.

DimensionReasoningScore

Specificity

Names the domain and three concrete actions ("review recent conversations and daily notes, extract insights, and consolidate into long-term memory"), but "review"/"extract" are slightly generic, so it stops short of comprehensive coverage at 5.

4 / 5

Completeness

Explicitly answers both what (review, extract insights, consolidate into long-term memory) and when ("Use when triggered by cron, heartbeat, or explicit request to reflect on recent activity") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural phrases a user would say ("reflect on recent activity", "consolidate", "review recent memory") plus trigger mechanisms ("cron, heartbeat"), but misses some common synonyms, landing at good-but-not-comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (background sleep-time memory consolidation) with distinct triggers (cron/heartbeat/explicit reflection request), minimizing overlap with other skills.

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

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.