About agent-memory
agent-memory is a skill for developers designing agent memory, covering conversation history, long-term memory, personalization, and context-window management. It explains buffer, summary, vector, and hybrid approaches, with a multi-layer architecture example.
Key features
- 01Buffer, summary, vector, and hybrid memory
- 02Session, user, and global persistence options
- 03Multi-layer memory architecture example
- 04Guidance for context overflow and retrieval issues
Use cases
- 01Add conversation history to an agent
- 02Design long-term or personalized memory
- 03Manage a limited context window
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ pluginagentmarketplace/ custom-plugin-ai-agents --skill agent-memoryAfter installing, type/agent-memoryin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
assets/config.yamlschema.jsonreferences/GUIDE.mdPATTERNS.mdscripts/multi_layer_memory.pyvalidate.pyDetails
From the project READMEAgent Memory
Give agents the ability to remember and learn across conversations.
When to Use This Skill
Invoke this skill when:
- Adding conversation history
- Implementing long-term memory
- Building personalized agents
- Managing context windows
Parameter Schema
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
task | string | Yes | Memory goal | - |
memory_type | enum | No | buffer, summary, vector, hybrid | hybrid |
persistence | enum | No | session, user, global | session |
Quick Start
from langchain.memory import ConversationBufferWindowMemory
# Simple buffer (last k messages)
memory = ConversationBufferWindowMemory(k=10)
# With summarization
from langchain.memory import ConversationSummaryBufferMemory
memory = ConversationSummaryBufferMemory(llm=llm, max_token_limit=2000)
# Vector store memory
from langchain.memory import VectorStoreRetrieverMemory
memory = VectorStoreRetrieverMemory(retriever=vectorstore.as_retriever())
Memory Types
| Type | Use Case | Pros | Cons |
|---|---|---|---|
| Buffer | Short chats | Simple | No compression |
| Summary | Long chats | Compact | Loses detail |
| Vector | Semantic recall | Relevant | Slower |
| Hybrid | Production | Best of all | Complex |
Multi-Layer Architecture
class ProductionMemory:
def __init__(self):
self.short_term = BufferMemory(k=10) # Recent
self.summary = SummaryMemory() # Compressed
self.long_term = VectorMemory() # Semantic
Troubleshooting
| Issue | Solution |
|---|---|
| Context overflow | Add summarization |
| Slow retrieval | Cache, reduce k |
| Irrelevant recall | Improve embeddings |
| Memory not persisting | Check storage backend |
Best Practices
- Use multi-layer memory for production
- Set token limits to prevent overflow
- Add metadata (timestamps, importance)
- Implement TTL for old memories
Related Skills
rag-systems- Vector retrievalllm-integration- Context managementai-agent-basics- Agent architecture
References
Comments
Markdown supported