How do I install the Memory Ebbinghaus skill?

Run npx skillmds@latest add knownasnaffy/memory-ebbinghaus-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Memory Ebbinghaus safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Memory Ebbinghaus?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Memory Ebbinghaus free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Memory Ebbinghaus?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Memory Ebbinghaus by knownasnaffy — Agent Skill

Name: Memory Ebbinghaus
Author: knownasnaffy

Memory Ebbinghaus

Ebbinghaus forgetting curve memory lifecycle manager for AI agents. Automatically calculates memory strength decay, supports review reinforcement, archiving, and deletion. Use when managing agent memory files, cleaning up stale knowledge, or implementing spaced repetition for long-term memory. Triggers on "memory management", "forgetting curve", "clean up memory", "which memories are fading", "review memory", "add memory item", "记忆管理", "遗忘曲线", "清理记忆", "哪些记忆快忘了", "复习记忆".

knownasnaffy Updated Sep 21, 2026 0 repo stars

File contents

Local Context Review

python scripts/_core.py is a local diagnostics helper for the Memory Ebbinghaus skill. It may inspect env. Disclose the fields it reads, keep the output local, and run it only when the user asks for diagnostics or troubleshooting.

Memory Ebbinghaus

Ebbinghaus forgetting curve-based memory lifecycle manager. Tracks memory items with strength decay, review reinforcement, and archiving.

Setup

First run — initialize the database:

python3 scripts/ebbinghaus.py status
# Auto-creates memory_db.json in current directory if not found

To use a custom path:

EBBINGHAUS_DB=/path/to/memory_db.json \
EBBINGHAUS_ARCHIVE=/path/to/MEMORY.md \
python3 scripts/ebbinghaus.py status

Environment variables:

Variable	Default	Description
`EBBINGHAUS_DB`	`./memory_db.json`	Path to the JSON database
`EBBINGHAUS_ARCHIVE`	`./MEMORY.md`	File to append archived memories

Core Concept

Strength formula: strength = e^(-days_elapsed / stability)

Status	Strength	Meaning
🟢 Active	≥ 0.7	Recently used, clear memory
🟡 Decaying	0.3–0.7	Not used for a while
🔴 Fading	< 0.3	Needs review or cleanup

Stability: starts at 1.0, multiplied by 1.5 on each review (the more you review, the slower it fades).

Commands

# View all memory items and their current strength
python3 scripts/ebbinghaus.py status

# Recalculate all strength values (run daily)
python3 scripts/ebbinghaus.py decay

# Add a new memory item
python3 scripts/ebbinghaus.py add "content description" --category <cat> --source <origin>

# Review and reinforce (resets strength to 1.0, stability ×1.5)
python3 scripts/ebbinghaus.py review <id>

# Delete a memory item
python3 scripts/ebbinghaus.py forget <id>

# Archive to MEMORY.md (removes from active list, appends to archive file)
python3 scripts/ebbinghaus.py archive <id>

# Heartbeat mode — print items needing attention
python3 scripts/ebbinghaus.py heartbeat

Heartbeat Integration

Add to your heartbeat config:

- Memory decay check: python3 /path/to/scripts/ebbinghaus.py heartbeat

Heartbeat output rules:

🔴 items exist → alert user, ask "review or forget?"
Only 🟡 items → log silently, no interruption
All 🟢 → output HEARTBEAT_OK

category	Meaning
`project`	Project/task completion
`tech`	Technical findings/solutions
`person`	Memory about someone
`event`	Important events
`general`	Other

Typical Workflows

"Clean up old memories":

Run decay then status
List 🔴 items, ask user: review / forget / archive?
Execute chosen action

"Remember this: XXX":

Run add "XXX"
Confirm added

"Which memories are fading?":

Run decay to update strengths
Run status, highlight 🔴 items

---name: memory-ebbinghaus-2description: Ebbinghaus forgetting curve memory lifecycle manager for AI agents. Automatically calculates memory strength decay, supports review reinforcement, archiving, and deletion. Use when managing agent memory files, cleaning up stale knowledge, or implementing spaced repetition for long-term memory. Triggers on "memory management", "forgetting curve", "clean up memory", "which memories are fading", "review memory", "add memory item", "记忆管理", "遗忘曲线", "清理记忆", "哪些记忆快忘了", "复习记忆".---### Local Context Review`python scripts/_core.py` is a local diagnostics helper for the `Memory Ebbinghaus` skill. It may inspect env. Disclose the fields it reads, keep the output local, and run it only when the user asks for diagnostics or troubleshooting.# Memory EbbinghausEbbinghaus forgetting curve-based memory lifecycle manager. Tracks memory items with strength decay, review reinforcement, and archiving.## SetupFirst run — initialize the database:```bashpython3 scripts/ebbinghaus.py status# Auto-creates memory_db.json in current directory if not found```To use a custom path:```bashEBBINGHAUS_DB=/path/to/memory_db.json \EBBINGHAUS_ARCHIVE=/path/to/MEMORY.md \python3 scripts/ebbinghaus.py status```**Environment variables:**| Variable | Default | Description ||----------|---------|-------------|| `EBBINGHAUS_DB` | `./memory_db.json` | Path to the JSON database || `EBBINGHAUS_ARCHIVE` | `./MEMORY.md` | File to append archived memories |## Core Concept**Strength formula**: `strength = e^(-days_elapsed / stability)`| Status | Strength | Meaning ||--------|----------|---------|| 🟢 Active | ≥ 0.7 | Recently used, clear memory || 🟡 Decaying | 0.3–0.7 | Not used for a while || 🔴 Fading | < 0.3 | Needs review or cleanup |**Stability**: starts at 1.0, multiplied by 1.5 on each review (the more you review, the slower it fades).## Commands```bash# View all memory items and their current strengthpython3 scripts/ebbinghaus.py status# Recalculate all strength values (run daily)python3 scripts/ebbinghaus.py decay# Add a new memory itempython3 scripts/ebbinghaus.py add "content description" --category <cat> --source <origin># Review and reinforce (resets strength to 1.0, stability ×1.5)python3 scripts/ebbinghaus.py review <id># Delete a memory itempython3 scripts/ebbinghaus.py forget <id># Archive to MEMORY.md (removes from active list, appends to archive file)python3 scripts/ebbinghaus.py archive <id># Heartbeat mode — print items needing attentionpython3 scripts/ebbinghaus.py heartbeat```## Heartbeat IntegrationAdd to your heartbeat config:```- Memory decay check: python3 /path/to/scripts/ebbinghaus.py heartbeat```Heartbeat output rules:- 🔴 items exist → alert user, ask "review or forget?"- Only 🟡 items → log silently, no interruption- All 🟢 → output `HEARTBEAT_OK`## Categories| category | Meaning ||----------|---------|| `project` | Project/task completion || `tech` | Technical findings/solutions || `person` | Memory about someone || `event` | Important events || `general` | Other |## Typical Workflows**"Clean up old memories"**:1. Run `decay` then `status`2. List 🔴 items, ask user: review / forget / archive?3. Execute chosen action**"Remember this: XXX"**:1. Run `add "XXX"`2. Confirm added**"Which memories are fading?"**:1. Run `decay` to update strengths2. Run `status`, highlight 🔴 items

Frequently asked questions

Memory Ebbinghaus

File contents

Local Context Review

Memory Ebbinghaus

Setup

Core Concept

Commands

Heartbeat Integration

Categories

Typical Workflows

Related skills

Frequently asked questions

How do I install the Memory Ebbinghaus skill?

What does the Memory Ebbinghaus skill do?

Is Memory Ebbinghaus safe to use?

Which AI agents work with Memory Ebbinghaus?

Is Memory Ebbinghaus free to use?

Who published Memory Ebbinghaus?