CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

38

Quality

24%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/antigravity-agent-memory-systems/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

22%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description reads like an introductory paragraph from a course syllabus rather than a functional skill description for Claude's skill selection. It lacks concrete actions, explicit trigger conditions, and practical specificity. The philosophical framing ('Memory is the cornerstone of intelligent agents') wastes space that should be used for actionable capability descriptions and trigger terms.

Suggestions

Replace the philosophical opening with concrete actions, e.g., 'Designs and implements agent memory systems including short-term context management, long-term vector store integration, and memory retrieval strategies.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about agent memory, context window management, vector databases for agents, RAG architectures, or how to make agents remember information across sessions.'

Remove abstract filler like 'Memory is the cornerstone of intelligent agents. Without it, every interaction starts from zero.' and replace with specific capabilities or supported patterns.

DimensionReasoningScore

Specificity

The description uses abstract, conceptual language ('cornerstone of intelligent agents', 'cognitive architectures') rather than listing concrete actions Claude can perform. It reads more like a textbook introduction than a skill description.

1 / 3

Completeness

The description vaguely addresses 'what' (covers architecture of agent memory) but provides no 'when' clause or explicit trigger guidance. There is no 'Use when...' or equivalent, which per the rubric should cap completeness at 2, and the 'what' itself is too abstract to score higher than 1.

1 / 3

Trigger Term Quality

It includes some relevant terms like 'memory', 'context window', 'vector stores', and 'agent memory' that users might mention, but these are presented in an explanatory rather than trigger-oriented way, and common user phrasings like 'remember', 'recall', 'store information' are missing.

2 / 3

Distinctiveness Conflict Risk

The focus on 'agent memory' and 'vector stores' provides some distinctiveness, but the broad framing around 'intelligent agents' and 'cognitive architectures' could overlap with general AI architecture or agent design skills.

2 / 3

Total

6

/

12

Passed

Implementation

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is comprehensive in coverage but severely over-engineered for a SKILL.md file. It reads more like a textbook chapter on agent memory systems than actionable instructions, with extensive explanations of concepts Claude already understands, repeated patterns (contextual chunking appears twice), and all content crammed into a single file. The code examples provide reasonable starting points but many rely on undefined helper functions and potentially inaccurate API signatures.

Suggestions

Split into multiple files: keep SKILL.md as a concise overview (~50-80 lines) with quick-start pattern, then reference separate files like VECTOR_STORES.md, CHUNKING.md, MEMORY_DECAY.md, and SHARP_EDGES.md

Remove explanatory content Claude already knows (what memory types are, what vector databases do, the 'chunking dilemma' explanation) and replace with terse decision rules

Move metadata sections (Capabilities, Scope, When to Use, Limitations, Collaboration) to YAML frontmatter or a separate METADATA.md

Add an explicit end-to-end workflow with numbered steps and validation checkpoints: e.g., 1) Choose memory type → 2) Select vector store → 3) Configure chunking → 4) Test retrieval accuracy → 5) Deploy with monitoring

DimensionReasoningScore

Conciseness

This is extremely verbose at ~600+ lines. It explains concepts Claude already knows (what memory types are, what vector databases do, what chunking is), includes extensive tooling comparison tables, and repeats patterns like contextual chunking multiple times. The 'Capabilities', 'Scope', 'When to Use', and 'Limitations' sections are metadata that belong in frontmatter, not body content. Much of this reads like a tutorial rather than actionable instructions.

1 / 3

Actionability

The code examples are mostly concrete and near-executable (LangMem, Pinecone, Qdrant, ChromaDB, chunking strategies), but many are pseudocode-like with undefined functions (e.g., `cluster_by_similarity`, `summarize`, `embed`, `resolve_conflict`, `is_contradictory` using LLM calls without real implementation). The LangMem API examples appear to be speculative rather than matching actual library APIs, reducing copy-paste readiness.

2 / 3

Workflow Clarity

The patterns are presented as isolated recipes rather than sequenced workflows. There's no clear end-to-end workflow showing how to set up a memory system from scratch. The 'Sharp Edges' section provides good problem-solution pairs, and the validation checks section adds some verification guidance, but there are no explicit validation checkpoints or feedback loops in the main patterns (e.g., no 'test retrieval accuracy after chunking' step integrated into the chunking workflow).

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no references to external files despite being 600+ lines. All content—tooling comparisons, multiple vector store implementations, chunking strategies, decay patterns, sharp edges, validation checks, collaboration notes—is inlined. This desperately needs to be split into separate files (e.g., CHUNKING.md, VECTOR_STORES.md, SHARP_EDGES.md) with the SKILL.md serving as an overview with navigation.

1 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
boisenoise/skills-collections
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.