CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

how-it-works

Explain how claude-mem captures observations, when memory injection kicks in, and where data lives. Use when the user asks "how does claude-mem work?" or "what is this thing doing?".

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

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

An exemplary lean informational skill: every token delivers claude-mem-specific knowledge, the structure exactly matches the description's three promises, and concrete commands appear wherever an action exists. The only improvement area is actionability detail, such as showing what an observation looks like or how to inspect the stored data.

Suggestions

Add a one-line sample observation so Claude can concretely illustrate what the observer writes when answering user questions.

Include a command for inspecting stored data (e.g., querying the SQLite database or listing observations) to make the 'where data lives' section fully actionable.

DimensionReasoningScore

Conciseness

Every sentence conveys claude-mem-specific facts (observer model, second-session injection timing, ~/.claude-mem contents, exact data-flow destinations) that Claude could not know otherwise; there is no padding or explanation of known concepts. Anchor 5's 'every token earns its place' fits; anchor 4 would require some trimmable over-explanation, which is absent.

5 / 5

Actionability

Provides concrete copy-paste commands ('/learn-codebase', 'npx claude-mem uninstall', 'npx claude-mem telemetry disable', 'DO_NOT_TRACK=1') and concrete locations (SQLite database, vector index), but leaves minor gaps such as a sample observation or a command to inspect stored data. This lands between anchor 4 ('mostly executable guidance... minor gaps') and anchor 5, closer to 4.

4 / 5

Workflow Clarity

A simple single-purpose informational skill under 50 lines whose sections ('What it does', 'When it kicks in', 'Where data lives') directly mirror the three questions the description promises, making the single action unambiguous; the simple-skill exception applies and no destructive or batch operations are involved.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external references and no bundle files present; the three well-organized sections are sufficient structure, satisfying the under-50-lines guideline for a top score.

5 / 5

Total

19

/

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 that clearly and explicitly states both what the skill explains and when to use it, with natural quoted trigger phrases and a distinct product-specific niche. The only minor gaps are a few missing trigger synonyms and slightly incomplete coverage of the topics the body actually addresses.

DimensionReasoningScore

Specificity

Names three concrete explanation targets ('captures observations', 'when memory injection kicks in', 'where data lives'), which goes beyond the 1-2 actions of anchor 3, but coverage is not comprehensive against what the skill actually covers (telemetry, data privacy, uninstall).

4 / 5

Completeness

Explicitly answers both 'what' (three named explanation topics) and 'when' with concrete quoted trigger phrases, exactly matching the anchor-5 example pattern; anchor 4's 'when could be more explicit' does not apply since the triggers are fully explicit.

5 / 5

Trigger Term Quality

Includes natural, directly quoted user phrases ('how does claude-mem work?' and 'what is this thing doing?'), but misses common variations such as 'what is claude-mem' or 'what are these observations', so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear product-specific niche (claude-mem) with distinct triggers that would not plausibly fire for any other skill, matching anchor 5's 'clear niche with distinct triggers; minimal conflict risk'.

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

thedotmack/claude-mem

Path

plugin/skills/how-it-works/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.