Agent skill · operations · alirezarezvani
self-improving-agent
Curate what the agent has learned into durable project knowledge. Reviews Claude Code auto-memory (MEMORY.md and its topic files) for learnings worth keeping, promotes proven ones into CLAUDE.md or .claude/rules/, records a correction as a lesson that persists across sessions, prunes stale or duplicate entries, and turns a recurring fix into a reusable skill. Use whenever the user asks what you have learned or saved about the project, which memories should become permanent rules, to remember a lesson or stop repeating a mistake, or to clean up, audit or check memory health.
Why this skill is useful
Adds executable commands for analyzing and promoting project knowledge, enhancing Claude's memory management capabilities.
What it needs
Requires claude-code, codex-cli, openclaw installed locally. About 4k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
Self-Improving Agent Auto-memory captures. This plugin curates. Claude Code's auto-memory (v2.1.32+) automatically records project patterns, debugging insights, and your preferences in MEMORY.md. This plugin adds the intelligence layer: it analyzes what Claude has learned, promotes proven patterns into project rules, and extracts recurring solutions into reusable skills. Quick Reference Command What it does --------- ------------- /si:memory-review Analyze MEMORY.md — find promotion candidates, stale entries, consolidation opportunities /si:promote Graduate a pattern from MEMORY.md → CLAUDE.md or .claude/rules/ /si:extract Turn a proven pattern into a standalone skill /si:memory-status Memory health dashboard — line counts, topic files, recommendations /si:remember Explicitly save important knowledge to auto-memory How It Fits Together Installation Claude Code (Plugin) OpenClaw Codex CLI Memory Architecture Where things live File Who writes Scope Loaded ------ ----------- ------- -------- ./CLAUDE.md You (+ /si:promote) Project rules Full file, every session ~/.claude/CLAUDE.md You Global preferences Full file, every session ~/.claude/projects/<path>/memory/MEMORY.md Claude (auto) Project learnings First 200 lines ~/.claude/projects/<path>/memory/.md Claude (overflow) Topic-specific notes On demand .claude/rules/.md You (+ /si:promote) Scoped rules When matching files open The promotion lifecycle Core Concepts Auto-memory is capture, not curation Auto-memory is excellent at recording what Claude learns. But it has no judgment about: Which learnings are temporary vs. permanent Which patterns should become enforced rules When the 200-line limit is wasting space on stale entries Which solutions are good enough to become reusable skills That's what this plugin does. Promotion = graduation When you promote a learning, it moves from Claude's scratchpad (MEMORY.md) to your project's rule system (CLAUDE.md or .claude/rules/). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/self-improving-agent--5c381d