CtrlK
BlogDocsLog inGet started
Tessl Logo

memory-recall

Search and recall relevant memories from past sessions via memsearch. Use when the user's question could benefit from historical context, past decisions, debugging notes, previous conversations, or project knowledge -- especially questions like 'what did I decide about X', 'why did we do Y', or 'have I seen this before'. Also use when you see `[memsearch] Recall available if needed` capability hints injected via SessionStart or UserPromptSubmit. Typical flow: search for 3-5 chunks, expand the most relevant, optionally deep-drill into original transcripts via the anchor format. Skip when the question is purely about current code state (use Read/Grep), ephemeral (today's task only), or the user has explicitly asked to ignore memory.

75

Quality

92%

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

85%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 tight, command-driven skill body with excellent sequencing, error-recovery fallbacks, and clean section structure for a single-purpose skill. The only deductions are minor: a duplicated fallback note, slightly over-explained rationale in Step 3, and an unresolved install-dir placeholder in the primary command that blocks copy-paste execution.

Suggestions

Replace the `__INSTALL_DIR__` placeholder in the collection-derivation command with a concrete resolution step (or document where it is substituted at install time) so the primary command is copy-paste executable.

State the `uvx memsearch` fallback once (e.g., in a short preamble note) instead of repeating it in both Steps 1 and 4.

Trim the Step 3 fallback to the essential instruction — 'if expand fails with a lock/permission error, read the source file using the provided `source` and `start_line`/`end_line`' — dropping the sandbox/Milvus rationale.

DimensionReasoningScore

Conciseness

The body is largely lean and assumes competence (no concept explanations, terse command-first steps), but has minor redundancy: "If memsearch is not found, try/use uvx memsearch instead" appears in both Steps 1 and 4, and the Step 3 fallback paragraph over-explains the sandbox rationale. This sits between anchor 5's 'every token earns its place' and anchor 3's 'some unnecessary explanation' — noticeably above the midpoint.

4 / 5

Actionability

Mostly executable: concrete commands like `memsearch search "<query>" --top-k 5 --json-output --default-collection` and fully-formed `MDIR=...` exploration snippets. However the entry-point collection-derivation command embeds an unresolved `__INSTALL_DIR__` placeholder and several commands use placeholder args, so it is not fully copy-paste ready — matching anchor 4's 'concrete code or commands with minor gaps' rather than anchor 5.

4 / 5

Workflow Clarity

Clear 5-step sequence (Search → Evaluate → Expand → Deep drill → Return) with explicit error-recovery feedback loops: uvx fallback when the binary is missing, direct file read when expand hits a lock error, and direct transcript-file exploration for unrecognized formats. The Evaluate step acts as a quality checkpoint; this is not a destructive/batch operation, so no validation cap applies.

5 / 5

Progressive Disclosure

No bundle files exist, and the body is under 50 lines with no need for external references — per the rubric's simple-skill guidance, well-organized sections alone warrant the top score. Sections (Project Collection, Steps, When unsure what to search, Output Format) are clear and each is appropriately scoped with nothing that belongs in a separate file.

5 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: it states concrete capabilities in third person, provides rich natural trigger phrases with quoted example questions, gives explicit use/skip conditions, and is anchored to a distinct tool. It is long, but every clause carries trigger or capability information rather than padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Search and recall relevant memories from past sessions via memsearch", "search for 3-5 chunks, expand the most relevant, optionally deep-drill into original transcripts" — covering the full capability surface. This matches the anchor for comprehensive concrete actions; anchor 4 would require noticeable coverage gaps, which are absent.

5 / 5

Completeness

Explicitly answers both what ("Search and recall relevant memories from past sessions via memsearch" plus the search/expand/deep-drill flow) and when (a clear "Use when..." clause with concrete trigger phrases, plus explicit skip conditions). This is a direct match for the anchor requiring both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Comprehensive natural phrasing users would actually say: "past decisions", "debugging notes", "previous conversations", "project knowledge", and quoted example questions like "why did we do Y" and "have I seen this before". Coverage includes synonyms and even a literal injected capability-hint trigger, exceeding anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

Clear niche (memory recall via the memsearch tool) with distinct triggers, including the literal `[memsearch] Recall available if needed` hint. Explicit skip guidance ("purely about current code state (use Read/Grep)") further reduces mis-triggering; no meaningful overlap with anchor 4's 'minor overlap risk with closely related skills'.

5 / 5

Total

20

/

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
zilliztech/memsearch
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.