CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engram-memory

ALWAYS ACTIVE — Selective persistent memory: preserve verified, durable knowledge worth reconstructing, with safe topic updates and host-owned lifecycle.

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./plugin/claude-code/skills/memory/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 a well-structured, highly actionable protocol: concrete tool usage, explicit field formats, sequenced workflows with validation and error-recovery branches, and lean imperative prose. The only real gaps are minor — a worked mem_save example, slight redundancy in the passive-capture section, and no reference split for the longer peripheral sections.

DimensionReasoningScore

Conciseness

The body is an imperative, dense protocol with no explanations of concepts Claude already knows; every section adds Engram-specific rules. Minor redundancy (the passive-capture 'safety net, not a replacement' point appears twice, and 'Do not skip step 1. Without it...' restates the preceding line) keeps it below a 5.

4 / 5

Actionability

Concrete tool names, a step-by-step search escalation ('First call mem_context... If not found, call mem_search... FTS5'), a full mem_save field spec with example titles, and a runnable fallback command ('engram setup claude-code'). Not 5 because a complete example mem_save call payload and several tool parameters are left unspecified.

4 / 5

Workflow Clarity

Each multi-step process is explicitly sequenced with checkpoints and error-recovery branches: search escalation (1→2→3), topic-update rules mandating read-before-overwrite verification ('On ambiguous identity or failed lookup, do not overwrite', 'A failed read is not evidence of absence'), failure handling in the delivery guarantee, and ordered compaction recovery with 'Only THEN continue'. Validation precedes the potentially destructive mem_update overwrite, so no cap applies.

5 / 5

Progressive Disclosure

A single-file skill with clear section headers, no buried or nested references, and nothing that requires external files to navigate. Not 5 because at ~101 lines it exceeds the under-50-line simple-skill exception and some content (the tool inventory, the fallback/troubleshooting details) could be offloaded to reference files.

4 / 5

Total

17

/

20

Passed

Description

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

The description states a clear, distinct 'what' in third person, but provides essentially no trigger guidance: 'ALWAYS ACTIVE' replaces rather than complements concrete 'Use when...' situations, and natural recall keywords users would say are missing. It reads as a policy declaration rather than a discoverable skill description.

Suggestions

Add an explicit trigger clause with natural user phrases, e.g. 'Use when the user says remember, recall, what did we do, or asks to persist knowledge across sessions.'

Enumerate the concrete capabilities (save, search, update by topic, session summaries) so the 'what' covers the full tool surface rather than only 'preserve' and 'topic updates'.

Drop or de-emphasize abstract qualifiers like 'host-owned lifecycle' in favor of keywords a user would naturally say when needing this skill.

DimensionReasoningScore

Specificity

Names the domain ('Selective persistent memory') and 1-2 actions ('preserve verified, durable knowledge', 'safe topic updates'), but 'host-owned lifecycle' is abstract and core actions like save/search/recall are not mentioned, so coverage is not comprehensive.

3 / 5

Completeness

The 'what' is clear ('preserve verified, durable knowledge worth reconstructing, with safe topic updates'), but there is no 'Use when...' clause or concrete trigger situations — 'ALWAYS ACTIVE' is a degenerate trigger that names no user context. Per the rubric guideline, missing trigger guidance caps completeness at 3; not 4 because 'ALWAYS ACTIVE' does not identify when a user needs this skill.

3 / 5

Trigger Term Quality

'persistent memory' is the only user-natural keyword; the natural phrases users actually say ('remember', 'recall', 'across sessions', 'what did we do') are entirely absent. Not 3 because no synonyms or variations of the one keyword are present.

2 / 5

Distinctiveness Conflict Risk

'Selective persistent memory... safe topic updates... host-owned lifecycle' carves a distinct niche with only minor overlap risk against other memory/note-taking skills. Not 5 because the absence of distinct trigger phrases leaves some conflict risk with generic memory skills.

4 / 5

Total

12

/

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

Gentleman-Programming/engram

Path

plugin/claude-code/skills/memory/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.