Analyze Auto-Memory — Development

Analyzes Claude Code's auto-memory to identify promotion candidates, stale entries, consolidation opportunities, and health metrics. Produces a structured report with actionable recommendations for improving memory management.

engineering claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Locates and reads the auto-memory directory and MEMORY.md
Analyzes entries for recurrence, staleness, and consolidation opportunities
Cross-references with CLAUDE.md and .claude/rules/ for duplicates and conflicts
Identifies promotion candidates meeting all criteria (seen 2+ sessions, broadly useful, actionable, not already in rules
Generates a health report with counts and recommendations

🎯 When to use it

After completing a major feature or debugging session
When MEMORY.md is over 150 lines or memory health is low
Weekly during active development to keep memory optimized
Before starting a new project phase or after onboarding a new team member

🚀 How to use

Trigger: /si:memory-review

Trigger with the slash command /si:memory-review or ask what has been learned and what should be promoted or pruned. Optionally use flags: --quick for summary, --stale for stale focus, --candidates for promotion focus. No additional input required; it reads the project's memory files automatically.

Example prompts:

/si:memory-review
/si:memory-review --quick

📄 Output: A formatted report showing memory health, promotion candidates, stale entries, consolidation groups, conflicts, and recommendations.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering-team/self-improving-agent/skills/memory-review .claude/skills/memory-review

Skill source: engineering-team/self-improving-agent/skills/memory-review/SKILL.md

⚠️ Good to know

Requires that auto-memory is enabled and the memory directory exists; if not, it will report that auto-memory may be disabled.

❓ FAQ

What does the --quick flag do?

It provides a summary only, showing counts and the top 3 promotion candidates.

What qualifies an entry as a promotion candidate?

An entry must appear in 2+ sessions, be broadly useful (not project-specific trivia), be actionable as a concrete rule, and not already exist in CLAUDE.md or .claude/rules/.

What should I do with stale entries?

Delete them promptly; auto-memory will re-learn if needed.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.