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

74%

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 ./skills/memory-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 delivers verified, executable quick-start code with a sensible section structure, but it is diluted by an oversized ASCII diagram and a redundant causal-pattern section, and its reference section points to two files that are missing from the bundle. Tightening the diagram and fixing or removing the dead references would lift both conciseness and navigation.

Suggestions

Remove or compress the 25-line ASCII Memory Types diagram into a short bullet list, leaving the detailed type documentation to references/MEMORY-TYPES.md.

Delete or create the two missing referenced files (references/RETRIEVAL-PATTERNS.md and scripts/knowledge_base.py) so all listed bundle paths resolve.

Make the quick-start examples fully copy-paste ready by defining project_dir (e.g. 'project_dir = Path(".")') and drop the redundant Causal Memory Pattern section, which restates the store_causal_chain example.

DimensionReasoningScore

Conciseness

The quick-start code examples are lean, but the 25-line ASCII box diagram under 'Memory Types' and the 'Causal Memory Pattern' section (which restates the store_causal_chain example as comments) are unnecessary padding that could be tightened into a few bullets. This matches the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

The body provides concrete, executable Python examples whose APIs (store, store_causal_chain, get_similar_errors) match the actual scripts/memory_manager.py implementation, with only minor gaps: 'project_dir' is never defined in the examples and the general store/retrieve/search API beyond causal chains is not shown. Not 5 because the examples are not fully copy-paste ready.

4 / 5

Workflow Clarity

As a single-purpose library skill, the quick-start actions (store a memory, store a causal chain, retrieve similar errors) are unambiguous and verified against real APIs. It falls short of 5 because multiple entry-point actions are shown without any guidance on when to store versus when to retrieve during a session, leaving the usage lifecycle implicit.

4 / 5

Progressive Disclosure

References and scripts are listed in clearly signaled dedicated sections, but 2 of the 6 referenced files do not exist in the bundle ('references/RETRIEVAL-PATTERNS.md' and 'scripts/knowledge_base.py'), and the inline 25-line Memory Types diagram duplicates content that belongs in references/MEMORY-TYPES.md. This matches the 'some structure but could be better organized' anchor rather than 4, since dead references and inline duplication are more than minor gaps.

3 / 5

Total

14

/

20

Passed

Description

76%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 well-constructed description that explicitly covers both what the skill does and when to use it, with mostly concrete capability language. The main weakness is trigger-term coverage: it leans on internal terminology ("causal memory chains") and misses the natural phrasings a user would say when needing persistent memory.

Suggestions

Add natural user phrasings as triggers, e.g. 'Use when the user says remember, recall, or asks what was learned from a previous session'.

Replace or supplement the jargon term 'causal memory chains' with plain-language equivalents like 'error-to-solution mappings' in the trigger clause.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("storing error patterns, retrieving learned solutions, managing causal memory chains, or persisting project knowledge"), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because 'persisting project knowledge' is generic and coverage has gaps (e.g., no mention of searching or recalling memories), but it exceeds 3 by naming more than 1-2 concrete actions.

4 / 5

Completeness

It clearly answers 'what' ("External persistent memory for cross-session knowledge") and explicitly answers 'when' with a concrete 'Use when' clause listing multiple trigger phrases ("Use when storing error patterns, retrieving learned solutions, managing causal memory chains, or persisting project knowledge"). This matches the anchor-5 pattern of both what and when with concrete triggers.

5 / 5

Trigger Term Quality

Relevant keywords are present ("memory", "store", "retrieve", "error patterns", "cross-session"), but common natural variations users would actually say ("remember", "recall", "learn from the last session") are missing, and "causal memory chains" is internal jargon rather than a user-spoken phrase. This matches the 'some relevant keywords but missing common variations or synonyms' anchor.

3 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (persistent memory, error→solution chains) with mostly distinct triggers, matching the 'mostly distinct; minor overlap risk' anchor. It is not 5 because "persisting project knowledge" is broad enough to overlap with general knowledge-management or note-taking skills.

4 / 5

Total

16

/

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

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.