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
24%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/antigravity-agent-memory-systems/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
431bfad
Table of Contents
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.