CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-memory-systems

Memory is the cornerstone of intelligent agents. Without it, every interaction starts from zero. This skill covers the architecture of agent memory: short-term (context window), long-term (vector stores), and the cognitive architectures that organize them. Key insight: Memory isn't just storage - it's retrieval. A million stored facts mean nothing if you can't find the right one. Chunking, embedding, and retrieval strategies determine whether your agent remembers or forgets. The field is fragm

Quality

55%

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 ./cli-tool/components/skills/ai-research/agent-memory-systems/SKILL.md

The canonical home for this skill is agent-memory-systems in sickn33/agentic-awesome-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 is a skeleton with visible damage: an unfinished sentence, empty Anti-Pattern sections, and a corrupted table whose cells contain stray markdown headers and placeholder 'Issue' values. What remains is persona prose and section titles that gesture at real topics without giving Claude anything to execute.

Suggestions

Repair the Sharp Edges table: give each row a real issue name (currently every row says 'Issue') and move the leaked '## Contextual Chunking (Anthropic's approach)'-style headers out of the Solution column into real solution guidance.

Replace the empty Anti-Pattern headers with concrete counter-examples, and expand each Pattern one-liner into actionable steps or decision criteria (e.g., how to choose a chunk size and test retrieval quality).

Complete the cut-off sentence ('...embedding quality, and') and drop the persona preamble and duplicate capabilities tag list, which restate the frontmatter without adding executable value.

DimensionReasoningScore

Conciseness

The body is short in absolute terms but a noticeable fraction is padding that assumes Claude's ignorance or adds persona ('You are a cognitive architect who understands that memory makes agents intelligent', 'Memory failures look like intelligence failures') and the 10-item capabilities tag list duplicates the frontmatter. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 2, since there is no lengthy concept tutorial, and not 4, because the persona prose and tag list are tokens that earn nothing.

3 / 5

Actionability

There is no code, command, or executable guidance anywhere; the Patterns are bare titles ('### Chunking Strategy Pattern — Breaking documents into retrievable chunks'), the Anti-Patterns are headers with no content, and the only concrete-ish hints are one-line table entries ('Test different sizes', 'Add temporal scoring'). This fits anchor 2 ('minimal concrete guidance; high-level hints but missing the specific steps to execute') rather than 1, because those terse hints are at least directionally concrete, and clearly not 3, since nothing here is actionable in the way pseudocode or partial steps would be.

2 / 5

Workflow Clarity

No multi-step process is ever sequenced: choosing a memory type, selecting a vector store, or chunking a document are each implied by section titles but no steps, order, or validation checkpoints are given, and the 'Sharp Edges' table that should serve as the error-recovery guide is corrupted. This matches anchor 2 ('rough sequence present but many gaps; steps poorly defined; validation absent') — the section skeleton implies an approach but defines no steps — and not 1, because the skeleton at least implies a coherent progression from patterns to pitfalls.

2 / 5

Progressive Disclosure

The body has section structure (Capabilities, Patterns, Anti-Patterns, Sharp Edges, Related Skills) and no bundle files exist to reference, but the sections are hollow husks — Anti-Patterns have zero content, the Sharp Edges table has repeated 'Issue' placeholders with leaked '##' headers in the Solution column, and one sentence terminates mid-thought ('embedding quality, and'). This fits anchor 3 ('some structure but could be better organized') rather than the simple-skill 5 exception, because the organization is broken rather than well-organized, and not 2, since there is no inlined bulk content that belongs in separate files.

3 / 5

Total

10

/

20

Passed

Description

53%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 identifies a real, fairly distinct niche and names concrete sub-topics, but it is written as philosophical prose rather than an action statement, has no 'Use when' trigger clause, and is literally truncated mid-word. It reads as an essay opening, not a routing description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when designing agent memory, building RAG/retrieval pipelines, or choosing vector stores and chunking strategies.'

Rewrite as third-person concrete actions ('Designs short-term and long-term memory architecture, selects vector stores, tunes chunking and retrieval') instead of declarative philosophy.

Fix the truncated tail ('The field is fragm') and add natural synonyms users actually say: 'remember', 'forget', 'RAG', 'vector database', 'knowledge base'.

DimensionReasoningScore

Specificity

The description names the domain and several concrete topics ('short-term (context window), long-term (vector stores)', 'Chunking, embedding, and retrieval strategies'), but these are concepts rather than actions — it says the skill 'covers the architecture' rather than what it does, and the text cuts off mid-word ('The field is fragm'). This fits anchor 3 (domain plus concrete topical coverage, not comprehensive action coverage) better than anchor 2, because the sub-topics are specific rather than generic, but not anchor 4, since no concrete executable actions are listed.

3 / 5

Completeness

A 'what' is present ('This skill covers the architecture of agent memory: short-term (context window), long-term (vector stores)...'), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not anchor 2 because the 'what' is clear and multi-part; not anchor 4 because the 'when' is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

Relevant keywords exist ('memory', 'agent memory', 'chunking', 'embedding', 'retrieval', 'vector stores', 'context window') but common natural variations users would say are missing ('remember', 'forget', 'RAG', 'vector database', 'knowledge base'). This matches anchor 3 ('some relevant keywords but missing common variations or synonyms'); it exceeds anchor 2 because the terms present go beyond generic jargon, and falls short of anchor 4 because several natural synonyms are absent.

3 / 5

Distinctiveness Conflict Risk

The agent-memory niche (chunking, embedding, retrieval, vector stores for agents) is mostly distinct with only minor overlap risk against closely related RAG/retrieval-augmentation or caching skills. It fits anchor 4 better than anchor 3 because the concrete sub-topics carve out a recognizable niche, and better than anchor 5 because the grandiose generic opening ('Memory is the cornerstone of intelligent agents') could still match broadly worded memory-related requests.

4 / 5

Total

13

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

davila7/claude-code-templates

Path

cli-tool/components/skills/ai-research/agent-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.