CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-systems

Design short-term, long-term, and graph-based memory architectures. Use when building agents that must persist across sessions, needing to maintain entity consistency across conversations, or implementing reasoning over accumulated knowledge.

Quality

65%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/memory-systems/SKILL.md

The canonical home for this skill is memory-systems in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

36%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 reads as a conceptual survey of memory architectures rather than an operational skill: it re-explains well-known concepts, duplicates its own opening material, and offers pseudocode instead of executable guidance. The strongest parts are the needs-to-architecture selection list and the layer taxonomy, but they are buried in verbose exposition, and the sole internal reference is a dangling pointer to a nonexistent file.

Suggestions

Delete the duplicated/garbled opening (the first 'When to Use This Skill' section, the mid-document H1, and the repeated context-memory spectrum paragraph) and cut the background exposition of vector RAG and knowledge graphs that Claude already knows, keeping only the parts specific to designing agent memory.

Replace the pseudocode examples (undefined `memory` and `temporal_graph` objects) with executable, concrete code — e.g., real Cypher against Neo4j and an actual embedding-store call — or explicitly justify them as schema sketches.

Turn 'Memory System Selection' into a numbered design workflow (gather requirements → choose layers → implement → validate retrieval accuracy) with validation checkpoints, and either create the referenced implementation-reference file or remove the dangling pointer.

DimensionReasoningScore

Conciseness

The body opens with a garbled, duplicated 'When to Use This Skill' section ("Use this skill when working with design short-term, long-term, and graph-based memory architectures"), repeats the context-memory spectrum paragraph verbatim (in 'Core Concepts' and again in 'Memory Architecture Fundamentals'), uses a second '## When to Use' section and a mid-document H1 ('# Memory System Design'), and spends multiple sections explaining concepts Claude already knows (what vector RAG is, how embedding similarity works, what knowledge graphs preserve). This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') — the padding is pervasive but the document is not entirely without useful material, so it is above anchor 1.

2 / 5

Actionability

There is some concrete guidance — the 'Memory System Selection' needs-to-architecture mapping, the consolidation process steps, and two code examples — but both code examples are pseudocode against undefined objects (`memory.store(...)`, `temporal_graph.query(...)`, `now()`), and much of the guidance describes rather than instructs ("Match memory architecture to query requirements"). This matches anchor 3 ('some concrete guidance but incomplete; pseudocode instead of executable code') — it has more concrete substance than anchor 2's high-level hints, but lacks anchor 4's executable code and commands.

3 / 5

Workflow Clarity

The body is organized by topic, not by process: there is no ordered sequence for the core task of designing a memory system, and no validation checkpoints. The closest artifacts are an unordered needs-mapping list and a consolidation step list with no error-recovery loop. This matches anchor 2 ('rough sequence present but many gaps; steps poorly defined') — guidance exists but the operational sequence and checkpoints are missing, falling short of anchor 3's 'steps listed' with only validation gaps.

2 / 5

Progressive Disclosure

The document has clear ## and ### section headers and a dedicated References section, but the 'Internal reference: Implementation Reference — Detailed implementation patterns' points to a file that does not exist in the bundle (no references/ directory), and long reference-grade material (the DMR benchmark table, detailed layer-by-layer exposition) is inlined rather than split out. This matches anchor 3 ('some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline') — the broken reference and duplication keep it from anchor 4, while the existing headers keep it above anchor 2.

3 / 5

Total

10

/

20

Passed

Description

78%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 clearly states both what the skill does and when to use it, with natural, multi-condition trigger phrasing. Its main weakness is that the capability statement rests on a single 'design' verb, leaving the breadth of what the skill covers implicit. Trigger and distinctiveness quality are solid with only minor gaps.

Suggestions

Expand the 'what' beyond the single verb 'design' to enumerate the concrete activities the skill supports (e.g., selecting among vector, graph, and temporal-knowledge-graph stores; implementing layered memory; defining consolidation schedules), raising specificity.

Add common trigger synonyms users would naturally say — such as 'agent memory', 'knowledge graph', or 'conversation history' — to strengthen trigger term coverage and distinguish it from adjacent context-engineering skills.

DimensionReasoningScore

Specificity

The only concrete action is "Design short-term, long-term, and graph-based memory architectures" — one design verb covering three named architecture types, with no further specific actions (no build, evaluate, or implement verbs). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than 4, which requires several distinct specific actions.

3 / 5

Completeness

It explicitly answers both: the "what" ("Design short-term, long-term, and graph-based memory architectures") and a concrete "Use when..." clause with three specific trigger conditions (persisting agents across sessions, entity consistency, reasoning over accumulated knowledge). This matches anchor 5 ('clearly and explicitly answers both what AND when with concrete trigger phrases') — the when-clause is specific and multi-conditioned, not merely adequate as in anchor 4.

5 / 5

Trigger Term Quality

Natural user phrases like "persist across sessions", "entity consistency", "reasoning over accumulated knowledge", and "building agents" are present, giving good keyword coverage. It falls short of anchor 5 because common variations users would say — e.g. "agent memory", "knowledge graph", "conversation history", "remember" — are absent.

4 / 5

Distinctiveness Conflict Risk

"Memory architectures" for agents with entity-consistency and temporal-reasoning triggers carves a clear niche, but the persist-across-sessions and shared-memory triggers overlap with closely related collection skills (multi-agent-patterns, context-fundamentals referenced in the body). This matches anchor 4 ('mostly distinct; minor overlap risk with closely related skills').

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/memory-systems/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.