CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-memory-system

Persistent memory architecture for AI agents across sessions. Episodic memory (past events), procedural memory (learned skills), semantic memory (knowledge graph), short-term memory (active context). Use when implementing cross-session persistence, skill learning, context preservation, personalization, or building truly adaptive AI systems with long-term memory.

Quality

69%

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/agent-memory-system/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

42%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 an architecture design document rather than an executable skill: it catalogs four memory types with illustrative schemas and undefined storeMemory/recallMemory APIs instead of runnable scripts or concrete build steps. Organization is decent section-by-section, but it is heavily padded, lacks validation checkpoints, and keeps everything in one monolithic file with a dangling reference to a nonexistent examples/ directory.

Suggestions

Cut the body to a concise overview and move each memory type's full JSON schema, hook scripts, and the vector-DB appendix into real reference files (e.g., references/episodic.md, references/hooks.sh), replacing the dangling "see examples/" pointer with links to files that actually exist.

Replace the undefined storeMemory/recallMemory pseudocode and recall-episode/get-skill/query-knowledge phantom CLIs with actual executable scripts in scripts/ (or concrete file-based read/write procedures using the declared Read/Write tools), fixing the "await recall Memory({" typo.

Define one end-to-end implementation workflow (initialize .memory/ layout → wire SessionStart/SessionEnd hooks → store first episode → verify retrieval) with explicit validation checkpoints, and delete the repeated per-type Benefits blocks and closing marketing paragraphs to cut length by half or more.

DimensionReasoningScore

Conciseness

The ~950-line body is noticeably padded: every memory type repeats a Structure/Operations/Queries/Benefits/Storage block with generic benefit lists ("Avoid repeating mistakes", "Make informed decisions"), and lines like "agent-memory-system enables persistent memory across sessions... the foundation for truly adaptive AI systems" restate the overview. Much of the JSON/TypeScript scaffolding (usage_count, success_rate, avg_quality_score) is illustrative detail Claude could derive, matching the 'several unnecessary explanations or padded sections' anchor rather than the mostly-efficient 3.

2 / 5

Actionability

Some concrete guidance exists (the SessionStart/SessionEnd bash hooks with find/ls/cp commands, the numbered nightly consolidation script), but the core operations are pseudocode against undefined APIs — "await storeMemory({...})", "recall-episode --similar \"implementing OAuth\"", "query-knowledge \"oauth\"" reference functions and CLIs that exist nowhere in the bundle, and one snippet even contains a typo ("await recall Memory({"). This sits squarely at 'some concrete guidance but incomplete; pseudocode instead of executable code'.

3 / 5

Workflow Clarity

Sequences exist — the four Core Operations (Store, Recall, Learn from Experience, Personalize) and the five-step nightly consolidation script are listed in order — but there is no end-to-end workflow for actually standing up the memory system, and validation checkpoints are entirely absent (nothing verifies a store succeeded or that a recalled episode is well-formed). The hook integrations gesture at a session lifecycle without connecting the pieces, matching 'steps listed but validation gaps; checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

Section headers and a Quick Reference table give real in-file structure, but the entire deep-dive material — four memory-type specifications, hook scripts, vector-DB appendix — is inlined in one ~950-line file that clearly belongs in split reference files, and the only outward reference ("For integration examples, see examples/.") points to a directory that does not exist in the bundle. This is 'some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline' — above the headerless-monolith 2, below the well-split 4.

3 / 5

Total

11

/

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: it states a clear what (four-layer persistent memory architecture) and an explicit, multi-trigger when clause in third person, with good natural trigger vocabulary. The main gap is component-naming instead of action-verbs, which slightly blurs what the skill concretely does.

DimensionReasoningScore

Specificity

"Episodic memory (past events), procedural memory (learned skills), semantic memory (knowledge graph), short-term memory (active context)" lists several concrete, distinct capabilities with brief functional glosses. It falls short of a 5 because it names components rather than executable actions — no verbs like 'store', 'recall', or 'extract patterns' — leaving coverage of what the skill actually does implied rather than stated.

4 / 5

Completeness

Explicitly answers both: what — "Persistent memory architecture for AI agents across sessions" plus the four enumerated memory types; when — "Use when implementing cross-session persistence, skill learning, context preservation, personalization, or building truly adaptive AI systems with long-term memory", a concrete multi-trigger 'Use when' clause. This matches the anchor example that clearly and explicitly covers both what and when.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "cross-session persistence", "skill learning", "context preservation", "personalization", "long-term memory" are phrases a user would plausibly say. A few common variations are missing (e.g., "remember across sessions", "recall", "knowledge base"), so it does not reach the comprehensive-with-synonyms level of a 5.

4 / 5

Distinctiveness Conflict Risk

The memory-architecture framing with the four typed layers (episodic/procedural/semantic/short-term) carves a fairly distinct niche with domain-specific triggers. Minor overlap risk remains with broader skills about session context management, note-taking, or knowledge bases, which keeps it below a 5.

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

skill_md_line_count

SKILL.md is long (958 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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