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

91%

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 lean, well-structured informational skill: every section delivers concrete facts (paths, commands, timing, privacy boundaries) that directly answer the description's three questions, with no padding beyond a few trimmable benefit clauses. The only improvement space is slightly richer coverage of adjacent user questions and tighter phrasing.

Suggestions

Trim the benefit clause '— no re-explaining the codebase, no re-discovering decisions' and merge the repeated machine-locality statements into one sentence.

Add one or two adjacent facts users of this skill commonly ask for, such as how to inspect stored observations or how to disable auto-injection, to close the minor actionability gaps.

DimensionReasoningScore

Conciseness

The ~150-word body is dense with claude-mem-specific facts ('Every Read, Edit, and Bash that Claude makes turns into a compressed observation', 'Everything stays in ~/.claude-mem'), assuming Claude's competence throughout. It falls just short of anchor 5 because of minor trimmable flourishes — 'no re-explaining the codebase, no re-discovering decisions' — and slight redundancy between 'on this machine' and 'Nothing leaves your machine'.

4 / 5

Actionability

Concrete, checkable facts throughout: the path '~/.claude-mem', the command 'Run /learn-codebase... (~5 minutes, optional)', the cleanup command 'npx claude-mem uninstall', and the timing rule 'Memory injection starts on your second session'. This fits 'Mostly executable guidance; concrete code or commands with minor gaps' — it stops short of anchor 5 only because some adjacent common cases (e.g., how to inspect what's stored, how to disable injection) are unaddressed.

4 / 5

Workflow Clarity

This is a simple single-purpose skill (answer 'how does claude-mem work'), and the single action is unambiguous: the three sections ('What it does', 'When it kicks in', 'Where data lives') mirror the description's three promises one-to-one. Per the simple-skill guideline this earns a 5; there are no destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

The body is under 50 lines, needs no external references (no references/, scripts/, or assets/ exist in the bundle, and none are cited), and is organized into clear sections that each answer one question. Per the under-50-lines guideline, well-organized sections alone earn a 5 here.

5 / 5

Total

18

/

20

Passed

Description

92%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: third-person voice, concrete capabilities, and explicit 'Use when...' triggers with natural quoted user questions. Its only weakness is keyword breadth — a few natural phrasings users might use (data storage, privacy, memory questions) are not covered.

Suggestions

Broaden trigger coverage with a few natural synonyms, e.g. 'Use when the user asks how memory works, where observations are stored, or whether data leaves the machine.'

Consider adding a privacy-oriented trigger phrase, since 'is my data sent anywhere' is a natural companion question the skill's body already answers.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'Explain how claude-mem captures observations, when memory injection kicks in, and where data lives' — covering capture, injection timing, and data location, which maps comprehensively onto the skill's scope. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; a 4 would require minor gaps in coverage, but all three facets of the skill are named explicitly.

5 / 5

Completeness

Explicitly answers both parts: the 'what' ('Explain how claude-mem captures observations, when memory injection kicks in, and where data lives') and the 'when' with concrete trigger phrases ('Use when the user asks "how does claude-mem work?" or "what is this thing doing?"'). This matches the anchor-5 example's structure exactly; a 4 would have a 'when' clause that is present but less explicit.

5 / 5

Trigger Term Quality

Includes two natural quoted user phrasings — 'how does claude-mem work?' and 'what is this thing doing?' — that a user would genuinely say. It falls short of the anchor-5 example's comprehensive synonym coverage: natural variants like 'how does memory work', 'where does it store my data', or 'is my data sent anywhere' are not covered.

4 / 5

Distinctiveness Conflict Risk

Names a clear niche (claude-mem internals) with distinct, product-specific triggers unlikely to fire for any other skill. It matches 'Clear niche with distinct triggers; minimal conflict risk'; a 4 would require minor overlap with closely related skills, and none is evident.

5 / 5

Total

19

/

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.