CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-manager

External persistent memory for cross-session knowledge. Use when storing error patterns, retrieving learned solutions, managing causal memory chains, or persisting project knowledge.

Quality

78%

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 ./.claude/skills/memory-manager/SKILL.md

The canonical home for this skill is memory-manager in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

65%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 compact, code-first overview whose API examples are accurate against the bundled scripts, but it stops at per-operation snippets: the causal self-healing workflow is only described, and a third of its referenced files are missing from the bundle. Tightening the duplicated type table into a pointer and sequencing the store/retrieve loop would raise the weaker dimensions.

Suggestions

Sequence the causal self-healing loop as explicit numbered steps (on error: call `get_similar_errors` → if a match, apply the solution and verify → otherwise fix it, then `store_causal_chain`) instead of describing it only in the 'Causal Memory Pattern' comments.

Fix the broken references: either create `references/RETRIEVAL-PATTERNS.md` and `scripts/knowledge_base.py` or remove them from the 'References' and 'Scripts' lists — both are listed in the body but absent from the bundle.

Replace the ~25-line inline ASCII 'MEMORY TYPES' table with a one-line pointer to `references/MEMORY-TYPES.md` so the detail lives only in the reference file.

DimensionReasoningScore

Conciseness

The body is mostly lean code examples and structure with no basic-concept padding, but the ~25-line ASCII 'MEMORY TYPES' box duplicates content already detailed in `references/MEMORY-TYPES.md`, and the 'Causal Memory Pattern' section is descriptive commentary that could be trimmed — minor over-inclusion rather than the 'some unnecessary explanation' of a 3.

4 / 5

Actionability

The Quick Start code (`memory.store(...)`, `memory.store_causal_chain(...)`, `memory.get_similar_errors(...)`) is real, executable, and verified against the actual `MemoryManager` API, including a shown return shape. Minor gaps keep it below 5: `project_dir` is never shown being constructed, and the `search()` path and common-case coverage beyond the three examples are absent.

4 / 5

Workflow Clarity

Individual usage patterns are concrete, but there is no end-to-end sequence for the skill's core loop (on error: `get_similar_errors` → apply learned solution → verify → else fix and `store_causal_chain`); the 'Causal Memory Pattern' section describes it in comments rather than as steps. Operations are single non-destructive calls, so no destructive cap applies, but the sequence is implicit — matching 'sequence present but checkpoints missing or implicit' better than anchor 4.

3 / 5

Progressive Disclosure

Sections are clear and references are well-signaled in dedicated 'References'/'Scripts' lists one level deep, but 2 of 6 referenced paths are dead — `references/RETRIEVAL-PATTERNS.md` and `scripts/knowledge_base.py` do not exist in the bundle — and the inline memory-types table duplicates the separate reference file. That is worse than anchor 4's 'minor organization gaps', but the body is a genuine overview with clear navigation, well above anchor 2.

3 / 5

Total

14

/

20

Passed

Description

83%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 in third-person voice that pairs a clear what with an explicit, multi-trigger 'Use when' clause mirroring the exemplar pattern. It is held below the top band only by slightly incomplete action coverage, a few missing natural synonyms, and mild breadth in 'persisting project knowledge'.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'storing error patterns', 'retrieving learned solutions', 'managing causal memory chains', 'persisting project knowledge' — but coverage has minor gaps (no mention of general keyword search, episodic session summaries, or clearing memories), so it sits at anchor 4 rather than the comprehensive coverage of anchor 5 and well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers both: 'what' ('External persistent memory for cross-session knowledge') and 'when' ('Use when storing error patterns, retrieving learned solutions, managing causal memory chains, or persisting project knowledge'), with concrete trigger phrases — the same shape as the anchor 5 example. It has an explicit 'Use when' clause, so the missing-trigger cap does not apply.

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would plausibly say ('error patterns', 'learned solutions', 'project knowledge'), but misses common synonyms such as 'remember', 'recall', 'previous fixes', or 'lessons learned' — 'a few natural terms missing' matches anchor 4 better than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Causal memory chains' and 'cross-session knowledge' carve a mostly distinct niche, but 'persisting project knowledge' is broad enough to overlap with generic knowledge-base/note-taking skills — 'mostly distinct; minor overlap risk' fits better than anchor 5's minimal conflict risk, and far better than anchor 3's generic overlap.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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