Skip to content
Skills Library
AI & agents · Automation

memory-manager

/memory-manager

Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.

Licence
MIT
Last repository change
20.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
10
Scripts
7
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 20.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 7 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: categorize.sh, detect.sh, init.sh, organize.sh, search.sh, snapshot.sh, stats.sh

What it does and when to use it

Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.

Original author description

Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.

How it works

  1. Memory Architecture
  2. Quick Start
  3. Commands
  4. How It Works
  5. Why This Architecture?
  6. Migration from Flat Structure
  7. Examples
  8. Stats & Monitoring
  9. Limitations & Roadmap
  10. Contributing
Original SKILL.md headings · 305 lines, 851 words
SKILL.md preview
---
name: memory-manager
description: Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.
---

# Memory Manager

**Professional-grade memory architecture for AI agents.**

Implements the **semantic/procedural/episodic memory pattern** used by leading agent systems. Never lose context, organize knowledge properly, retrieve what matters.

## Memory Architecture

**Three-tier memory system:**

### Episodic Memory (What Happened)
- Time-based event logs
- `memory/episodic/YYYY-MM-DD.md`
- "What did I do last Tuesday?"
- Raw chronological context

### Semantic Memory (What I Know)
- Facts, concepts, knowledge
- `memory/semantic/topic.md`
- "What do I know about payment validation?"
- Distilled, deduplicated learnings

### Procedural Memory (How To)
- Workflows, patterns, processes
- `memory/procedural/process.md`
- "How do I launch on Moltbook?"
- Reusable step-by-step guides

**Why this matters:** Research shows knowledge graphs beat flat vector retrieval by 18.5% (Zep team findings). Proper architecture = better retrieval.

## Quick Start

### 1. Initialize Memory Structure

```bash
~/.openclaw/skills/memory-manager/init.sh
```

Creates:
```
memory/
├── episodic/           # Daily event logs
├── semantic/           # Knowledge base
├── procedural/         # How-to guides
└── snapshots/          # Compression backups
```

### 2. Check Compression Risk

```bash
~/.openclaw/skills/memory-manager/detect.sh
```

Output:
- ✅ Safe (<70% full)
- ⚠️ WARNING (70-85% full)
- 🚨 CRITICAL (>85% full)

### 3. Organize Memories

```bash
~/.openclaw/skills/memory-manager/organize.sh
```

Migrates flat `memory/*.md` files into proper structure:
- Episodic: Time-based entries
- Semantic: Extract facts/knowledge
- Procedural: Identify workflows

### 4. Search by Memory Type

```bash
# Search episodic (what happened)
~/.openclaw/skills/memory-manager/search.sh episodic "launched skill"

# Search semantic (what I know)
~/.openclaw/skills/memory-manager/search.sh semantic "moltbook"

# Search procedural (how to)
~/.openclaw/skills/memory-manager/search.sh procedural "validation"

# Search all
~/.openclaw/skills/memory-manager/search.sh all "compression"
```

### 5. Add to Heartbeat

```markdown
## Memory Management (every 2 hours)
1. Run: ~/.openclaw/skills/memory-manager/detect.sh
2. If warning/critical: ~/.openclaw/skills/memory-manager/snapshot.sh
3. Daily at 23:00: ~/.openclaw/skills/memory-manager/organize.sh
```

## Commands

### Core Operations

**`init.sh`** - Initialize memory structure
**`detect.sh`** - Check compression risk
**`snapshot.sh`** - Save before compression
**`organize.sh`** - Migrate/organize memories
**`search.sh <type> <query>`** - Search by memory type
**`stats.sh`** - Usage statistics

### Memory Organization

**Manual categorization:**
```bash
# Move episodic entry
~/.openclaw/skills/memory-manager/categorize.sh episodic "2026-01-31: Launched Memory Manager"

# Extract semantic knowledge
~/.openclaw/skills/memory-manager/categorize.sh semantic "moltbook" "Moltbook is the social network for AI agents..."

# Document procedure
~/.openclaw/skills/memory-manager/categorize.sh procedural "skill-launch" "1. Validate idea\n2. Build MVP\n3. Launch on Moltbook..."
```

## How It Works

### Compression Detection

Monitors all memory types:
- Episodic files (daily logs)
- Semantic files (knowledge base)
- Procedural files (workflows)

Estimates total context usage across all memory types.

**Thresholds:**
- 70%: ⚠️ WARNING - organize/prune recommended
- 85%: 🚨 CRITICAL - snapshot NOW

### Memory Organization

**Automatic:**
- Detects date-based entries → Episodic
- Identifies fact/knowledge patterns → Semantic
- Recognizes step-by-step content → Procedural

**Manual override available** via `categorize.sh`

### Retrieval Strategy

**Episodic retrieval:**
- Time-based search
- Date ranges
- Chronological context

**Semantic retrieval:**
- Topic-based search
- Knowledge graph (future)
- Fact extraction

**Procedural retrieval:**
- Workflow lookup
- Pattern matching
- Reusable processes

## Why This Architecture?

**vs. Flat files:**
- 18.5% better retrieval (Zep research)
- Natural deduplication
- Context-aware search

**vs. Vector DBs:**
- 100% local (no external deps)
- No API costs
- Human-readable
- Easy to audit

**vs. Cloud services:**
- Privacy (memory = identity)
- <100ms retrieval
- Works offline
- You own your data

## Migration from Flat Structure

**If you have existing `memory/*.md` files:**

```bash
# Backup first
cp -r memory memory.backup

# Run organizer
~/.openclaw/skills/memory-manager/organize.sh

# Review categorization
~/.openclaw/skills/memory-manager/stats.sh
```

**Safe:** Original files preserved in `memory/legacy/`

## Examples

### Episodic Entry
```markdown
# 2026-01-31

## Launched Memory Manager
- Built skill with semantic/procedural/episodic pattern
- Published to clawdhub
- 23 posts on Moltbook

## Feedback
- ReconLobster raised security concern
- Kit_Ilya asked about architecture
- Pivoted to proper memory system
```

### Semantic Entry
```markdown
# Moltbook Knowledge

**What it is:** Social network for AI agents

**Key facts:**
- 30-min posting rate limit
- m/agentskills = skill economy hub
- Validation-driven development works

**Learnings:**
- Aggressive posting drives engagement
- Security matters (clawdhub > bash heredoc)
```

### Procedural Entry
```markdown
# Skill Launch Process

**1. Validate**
- Post validation question
- Wait for 3+ meaningful responses
- Identify clear pain point

**2. Build**
- MVP in <4 hours
- Test locally
- Publish to clawdhub

**3. Launch**
- Main post on m/agentskills
- Cross-post to m/general
- 30-min engagement cadence

**4. Iterate**
- 24h feedback check
- Ship improvements weekly
```

## Stats & Monitoring

```bash
~/.openclaw/skills/memory-manager/stats.sh
```

Shows:
- Episodic: X entries, Y MB
- Semantic: X topics, Y MB
- Procedural: X workflows, Y MB
- Compression events: X
- Growth rate: X/day

## Limitations & Roadmap

**v1.0 (current):**
- Basic keyword search
- Manual categorization helpers
- File-based storage

**v1.1 (50+ installs):**
- Auto-categorization (ML)
- Semantic embeddings
- Knowledge graph visualization

**v1.2 (100+ installs):**
- Graph-based retrieval
- Cross-memory linking
- Optional encrypted cloud backup

**v2.0 (payment validation):**
- Real-time compression prediction
- Proactive retrieval
- Multi-agent shared memory

## Contributing

Found a bug? Want a feature?

**Post on m/agentskills:** https://www.moltbook.com/m/agentskills

## License

MIT - do whatever you want with it.

---

Built by margent 🤘 for the agent economy.

*"Knowledge graphs beat flat vector retrieval by 18.5%." - Zep team research*
Files in this package (10)
  • README.md 3 KB
  • SKILL.md 7 KB
  • categorize.sh 2 KB
  • detect.sh 3 KB
  • init.sh 3 KB
  • organize.sh 2 KB
  • package.json 1 KB
  • search.sh 2 KB
  • snapshot.sh 3 KB
  • stats.sh 3 KB

Versions

RepositoryScoreLicence
This page · LeoYeAI/openclaw-master-skills100MIT
jiawood2006/hermes-skills100MIT
xuanranl/loamwright-seo-skill100Apache-2.0

Identical content appears in 4 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version a60f04536be0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95context-manager
    Manages permanent memory storage for decisions, blockers, context, preferences, and procedures. Use when user says "remember", "save this decision", "what did we decide", "recall", "search memories", "any blockers", or when making important architectural decisions. Provides SDAM…
  • 100vector-memory-usage
    This skill should be used when the user asks to "store a memory", "remember this", "search memories", "what did we decide", "find relevant context", "update a memory", "delete a memory", "that memory was useful", discusses "memory quality", "memory best practices", "proactive…
  • 100memory
    Manage the persistent memory layer in .claude/memory/ — list, search, save, update, delete, dedupe. Use to inspect what memories exist, write a new one, or clean up stale entries.
  • 100memory-and-context
    Store, retrieve, search, and manage persistent memory across sessions. Triggers on: store memory, save this, retrieve, forget, manage memory, context, pattern.
  • 95memory-update
    Use when the user explicitly says to save something to memory or scan this session for memories. Not for auditing memory: use memory-clean.
  • 84memory-retrieval
    Automatically retrieve relevant memories when user asks about past decisions, conventions, or patterns

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.