CtrlK
BlogDocsLog inGet started
Tessl Logo

memory-capture

Capture the current state of a working thread or conversation into a single coherent Basic Memory note — synthesize where it landed, don't append a log. On re-capture, rewrite the same note in place instead of duplicating. Use mid-thread or end-of-thread when decisions, insights, or context are worth preserving.

68

Quality

81%

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

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

The body is highly actionable, with executable tool calls and two worked examples that concretely demonstrate the update-in-place behavior, and the decision flow is clearly sequenced with an explicit escape hatch. Its weaknesses are repetition — duplicate tool-call listings and a rule stated three times — and a missing post-write verification step for a destructive overwrite. Restructuring the redundancy into an external examples file would improve both token efficiency and progressive disclosure.

Suggestions

Consolidate the duplicated search_notes/read_note/write_note listings: keep the complete signatures in 'MCP Tools Used' and reference them from 'Decision Flow' (or vice versa) instead of repeating both.

State the 'synthesize, don't append' rule once — in 'Synthesis Rules' — and cut its restatements in 'Purpose' and 'Best Practices', which currently repeat the same guidance.

Add a post-write verification step (e.g., read the note back after write_note with overwrite=True to confirm coherence) to close the validation gap for the destructive overwrite path.

DimensionReasoningScore

Conciseness

Mostly efficient — no tutorials on concepts Claude already knows — but noticeably redundant: the same search_notes calls appear in full in both 'Decision Flow' and 'MCP Tools Used', the 'synthesize, don't append' rule is restated three times across Purpose, Synthesis Rules, and Best Practices, and the two complete example notes (~85 lines) inflate the body. Fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4 because the duplication is systematic, not a minor instance.

3 / 5

Actionability

Fully executable, copy-paste-ready MCP tool signatures (search_notes with metadata_filters vs. query, read_note by permalink, write_note with metadata and overwrite=True), a concrete note-structure template, and two worked examples covering both the create and update paths. This matches the anchor-5 'specific examples cover the common cases' bar; it is clearly above anchor 4, where key details would be missing.

5 / 5

Workflow Clarity

The 'Decision Flow' section gives a clear 4-step numbered sequence with explicit match/no-match branches, a lookup-first checkpoint ('Read the existing note (use the full permalink returned by search)'), and an escape hatch for the user-requested-separate-note case. It falls short of anchor 5 because there is no post-write verification step for a destructive overwrite (write_note with overwrite=True) — the sequence stops at 'Save it', leaving the validate-after-write feedback loop absent.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so this is judged on internal structure: well-organized, clearly headed sections with everything one level deep and no buried or nested references. It fits anchor 4 ('good structure; most content is appropriately placed') rather than 5 because the ~270-line monolith inlines the second full example note and the observation-category taxonomy, content that could sensibly live in a separate examples/reference file.

4 / 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 description: it explicitly states what the skill does, when to use it, and pins itself to a specific tool and behavior (rewrite-in-place vs. duplicate), in concise third-person voice. Minor gaps are the absence of common user phrasings like 'save/remember/summarize' and slightly incomplete action enumeration.

DimensionReasoningScore

Specificity

Names several concrete actions ('Capture the current state of a working thread', 'synthesize where it landed', 'rewrite the same note in place instead of duplicating') tied to a specific tool (Basic Memory). Falls short of anchor 5 because the action coverage, while specific, is not exhaustive — e.g., it omits note structure, tagging, and the search/lookup behavior.

4 / 5

Completeness

Clearly answers both what ('Capture the current state of a working thread... into a single coherent Basic Memory note — synthesize where it landed, don't append a log') and when ('Use mid-thread or end-of-thread when decisions, insights, or context are worth preserving') with concrete trigger phrases, matching the anchor-5 example pattern. Not below 5: the 'when' clause is explicit, not weakly implied as at anchor 4.

5 / 5

Trigger Term Quality

Natural terms like 'capture', 'thread', 'conversation', 'mid-thread or end-of-thread', and 'decisions, insights, or context are worth preserving' map well to what users would say. A few natural variations are missing — users would commonly say 'save', 'remember', or 'summarize' what was discussed — so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche — Basic Memory note capture with rewrite-in-place semantics on re-capture — with distinct triggers. Conflict risk with generic note or memory skills is minimal; it clearly matches the anchor-5 'clear niche with distinct triggers' example and is more targeted than the anchor-4 'minor overlap risk' case.

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.

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.