CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mem-search

Search claude-mem persistent cross-session memory through enforced progressive disclosure. Use for previous decisions, solutions, work history, and before saving your own durable notes.

Quality

86%

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-engineered, lean instruction skill: the mem_search protocol is fully actionable with concrete parameterized examples, a clearly sequenced three-step guided flow with stop criteria and recovery guidance, and an explicit auto-mode fallback. The only refinements are trimming a few redundant restatements of the disclosure discipline and potentially externalizing reference material as the skill grows.

DimensionReasoningScore

Conciseness

The body is dense and purposeful with no explanation of concepts Claude already knows, but the progressive-disclosure discipline is restated a few times ('Do not start by fetching full records', 'Empty matches need no detail fetch', 'Request only what answers the question'), matching 'efficient; minor instances of over-explanation that could be trimmed'. Not a 5 because of that slight redundancy; not a 3 since the padding is minor and localized.

4 / 5

Actionability

Concrete copy-paste tool calls with real parameters cover both flows ('mem_search(query=..., mode="guided", limit=20)' and 'mode="auto", limit=12, maxDetails=3'), plus a get_tool_uses example and exact budgets (500 chars/1024 bytes, limit 1-20, maxDetails 1-5, 15-minute continuation expiry), matching 'fully executable; specific examples cover the common cases'. The only placeholders are runtime cursors and IDs, which are inherently dynamic.

5 / 5

Workflow Clarity

The guided flow is a numbered three-step sequence with explicit checkpoints (read titles, choose IDs, review context, filter), a stop criterion ('If the index or context is sufficient, stop'), and feedback loops (weak auto result → refine query or switch to guided mode; invalid continuation → restart with a query), matching the top anchor. All operations are read-only retrieval, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist and the ~115-line body is organized into well-labeled, navigable sections with everything appropriately inlined for a tool-protocol skill, matching 'good structure; most content is appropriately placed'. It is not a 5 because it exceeds the under-50-line simple-skill threshold and self-contained sections like 'Budgets and IDs' or 'Compatibility tools' could live in reference files; not a 3 because nothing is a monolithic wall or buried.

4 / 5

Total

18

/

20

Passed

Description

78%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 concise, third-person description with an explicit and well-structured 'Use for' trigger clause covering both what the skill does and when to invoke it. Its main weakness is thin capability coverage — only 'Search' is stated as an action — plus a minor trigger overlap with note-taking skills.

Suggestions

Enumerate 1-2 more concrete capabilities in the 'what' clause (e.g., 'retrieves past session evidence: decisions, resolved failures, and tool outputs') to lift specificity beyond a single action.

Add natural trigger synonyms such as 'recall', 'past sessions', or 'previous work' to broaden the natural-phrasing coverage.

Sharpen the 'before saving your own durable notes' trigger so it clearly points at claude-mem note-taking rather than any note-saving skill.

DimensionReasoningScore

Specificity

The description names its domain ('claude-mem persistent cross-session memory') and one concrete action ('Search') but lists no additional capabilities, matching the '1-2 concrete actions, not comprehensive' anchor. It stops short of anchor 4, which expects several specific actions enumerated.

3 / 5

Completeness

It explicitly answers 'what' ('Search claude-mem persistent cross-session memory through enforced progressive disclosure') and 'when' with an explicit 'Use for' clause naming four concrete trigger scenarios, matching the top anchor. It is not a 4 because the 'when' is already explicit and specific rather than merely improvable.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'previous decisions, solutions, work history, and before saving your own durable notes' give good keyword coverage. It falls short of anchor 5 because common synonyms and variations ('recall', 'remember', 'past sessions', 'memory lookup') are missing.

4 / 5

Distinctiveness Conflict Risk

The claude-mem binding gives it a clear niche with distinct triggers, but 'before saving your own durable notes' overlaps the trigger surface of a sibling note-taking skill, matching 'mostly distinct; minor overlap risk with closely related skills'. Not a 5 due to that overlap; not a 3 since the target system is unambiguous.

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

thedotmack/claude-mem

Path

plugin/skills/mem-search/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.