Agent skill

memory-management

AgentDB memory system with HNSW vector search. Provides 150x-12,500x faster pattern retrieval, persistent storage, and semantic search capabilities for learning and knowledge management. Use when: need to store successful patterns, searching for similar solutions, semantic lookup of past work, learning from previous tasks, sharing knowledge between agents, building knowledge base. Skip when: no learning needed, ephemeral one-off tasks, external data sources available, read-only exploration.

View SKILL.md on GitHub Repository
Stars 31,446
Forks 3,514

Install this agent skill to your Project

npx add-skill https://github.com/ruvnet/ruflo/tree/main/.agents/skills/memory-management

SKILL.md

Memory Management Skill

Purpose

AgentDB memory system with HNSW vector search. Provides 150x-12,500x faster pattern retrieval, persistent storage, and semantic search capabilities for learning and knowledge management.

When to Trigger

  • need to store successful patterns
  • searching for similar solutions
  • semantic lookup of past work
  • learning from previous tasks
  • sharing knowledge between agents
  • building knowledge base

When to Skip

  • no learning needed
  • ephemeral one-off tasks
  • external data sources available
  • read-only exploration

Commands

Store Pattern

Store a pattern or knowledge item in memory

bash
npx @claude-flow/cli memory store --key "[key]" --value "[value]" --namespace patterns

Example:

bash
npx @claude-flow/cli memory store --key "auth-jwt-pattern" --value "JWT validation with refresh tokens" --namespace patterns

Semantic Search

Search memory using semantic similarity

bash
npx @claude-flow/cli memory search --query "[search terms]" --limit 10

Example:

bash
npx @claude-flow/cli memory search --query "authentication best practices" --limit 5

Retrieve Entry

Retrieve a specific memory entry by key

bash
npx @claude-flow/cli memory get --key "[key]" --namespace [namespace]

Example:

bash
npx @claude-flow/cli memory get --key "auth-jwt-pattern" --namespace patterns

List Entries

List all entries in a namespace

bash
npx @claude-flow/cli memory list --namespace [namespace]

Example:

bash
npx @claude-flow/cli memory list --namespace patterns --limit 20

Delete Entry

Delete a memory entry

bash
npx @claude-flow/cli memory delete --key "[key]" --namespace [namespace]

Initialize HNSW Index

Initialize HNSW vector search index

bash
npx @claude-flow/cli memory init --enable-hnsw

Memory Stats

Show memory usage statistics

bash
npx @claude-flow/cli memory stats

Export Memory

Export memory to JSON

bash
npx @claude-flow/cli memory export --output memory-backup.json

Scripts

Script Path Description
memory-backup .agents/scripts/memory-backup.sh Backup memory to external storage
memory-consolidate .agents/scripts/memory-consolidate.sh Consolidate and optimize memory

References

Document Path Description
HNSW Guide docs/hnsw.md HNSW vector search configuration
Memory Schema docs/memory-schema.md Memory namespace and schema reference

Best Practices

  1. Check memory for existing patterns before starting
  2. Use hierarchical topology for coordination
  3. Store successful patterns after completion
  4. Document any new learnings

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

ruvnet/ruflo

add-model-descriptions

Add descriptions for new models from the HuggingFace router to chat-ui configuration. Use when new models are released on the router and need descriptions added to prod.yaml and dev.yaml. Triggers on requests like "add new model descriptions", "update models from router", "sync models", or when explicitly invoking /add-model-descriptions.

31,446 3,514
Explore
ruvnet/ruflo

agent-swarm-pr

Agent skill for swarm-pr - invoke with $agent-swarm-pr

31,446 3,514
Explore
ruvnet/ruflo

agent-neural-network

Agent skill for neural-network - invoke with $agent-neural-network

31,446 3,514
Explore
ruvnet/ruflo

agent-performance-analyzer

Agent skill for performance-analyzer - invoke with $agent-performance-analyzer

31,446 3,514
Explore
ruvnet/ruflo

agent-researcher

Agent skill for researcher - invoke with $agent-researcher

31,446 3,514
Explore
ruvnet/ruflo

V3 Memory Unification

Unify 6+ memory systems into AgentDB with HNSW indexing for 150x-12,500x search improvements. Implements ADR-006 (Unified Memory Service) and ADR-009 (Hybrid Memory Backend).

31,446 3,514
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results