Files
claude-skills-reference/docs/skills/engineering-team/self-improving-agent-review.md
Reza Rezvani 2f57ef8948 feat(agenthub): add AgentHub plugin with cross-domain examples, SEO optimization, and docs site fixes
- AgentHub: 13 files updated with non-engineering examples (content drafts,
  research, strategy) — engineering stays primary, cross-domain secondary
- AgentHub: 7 slash commands, 5 Python scripts, 3 references, 1 agent,
  dry_run.py validation (57 checks)
- Marketplace: agenthub entry added with cross-domain keywords, engineering
  POWERFUL updated (25→30), product (12→13), counts synced across all configs
- SEO: generate-docs.py now produces keyword-rich <title> tags and meta
  descriptions using SKILL.md frontmatter — "Claude Code Skills" in site_name
  propagates to all 276 HTML pages
- SEO: per-domain title suffixes (Agent Skill for Codex & OpenClaw, etc.),
  slug-as-title cleanup, domain label stripping from titles
- Broken links: 141→0 warnings — new rewrite_skill_internal_links() converts
  references/, scripts/, assets/ links to GitHub source URLs; skills/index.md
  phantom slugs fixed (6 marketing, 7 RA/QM)
- Counts synced: 204 skills, 266 tools, 382 refs, 16 agents, 17 commands,
  21 plugins — consistent across CLAUDE.md, README.md, docs/index.md,
  marketplace.json, getting-started.md, mkdocs.yml
- Platform sync: Codex 163 skills, Gemini 246 items, OpenClaw compatible

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 12:10:46 +01:00

4.6 KiB

title, description
title description
/si:review — Analyze Auto-Memory — Agent Skill & Codex Plugin Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw.

/si:review — Analyze Auto-Memory

:material-code-braces: Engineering - Core :material-identifier: `review` :material-github: Source
Install: claude /plugin install engineering-skills

Performs a comprehensive audit of Claude Code's auto-memory and produces actionable recommendations.

Usage

/si:review                    # Full review
/si:review --quick            # Summary only (counts + top 3 candidates)
/si:review --stale            # Focus on stale/outdated entries
/si:review --candidates       # Show only promotion candidates

What It Does

Step 1: Locate memory directory

# Find the project's auto-memory directory
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"

# Fallback: check common path patterns
# ~/.claude/projects/<user>/<project>/memory/
# ~/.claude/projects/<absolute-path>/memory/

# List all memory files
ls -la "$MEMORY_DIR"/

If memory directory doesn't exist, report that auto-memory may be disabled. Suggest checking with /memory.

Step 2: Read and analyze MEMORY.md

Read the full MEMORY.md file. Count lines and check against the 200-line startup limit.

Analyze each entry for:

  1. Recurrence indicators

    • Same concept appears multiple times (different wording)
    • References to "again" or "still" or "keeps happening"
    • Similar entries across topic files
  2. Staleness indicators

    • References files that no longer exist (find to verify)
    • Mentions outdated tools, versions, or commands
    • Contradicts current CLAUDE.md rules
  3. Consolidation opportunities

    • Multiple entries about the same topic (e.g., three lines about testing)
    • Entries that could merge into one concise rule
  4. Promotion candidates — entries that meet ALL criteria:

    • Appeared in 2+ sessions (check wording patterns)
    • Not project-specific trivia (broadly useful)
    • Actionable (can be written as a concrete rule)
    • Not already in CLAUDE.md or .claude/rules/

Step 3: Read topic files

If MEMORY.md references or the directory contains additional files (debugging.md, patterns.md, etc.):

  • Read each one
  • Cross-reference with MEMORY.md for duplicates
  • Check for entries that belong in the main file (high value) vs. topic files (details)

Step 4: Cross-reference with CLAUDE.md

Read the project's CLAUDE.md (if it exists) and compare:

  • Are there MEMORY.md entries that duplicate CLAUDE.md rules? (→ remove from memory)
  • Are there MEMORY.md entries that contradict CLAUDE.md? (→ flag conflict)
  • Are there MEMORY.md patterns not yet in CLAUDE.md that should be? (→ promotion candidate)

Also check .claude/rules/ directory for existing scoped rules.

Step 5: Generate report

Output format:

📊 Auto-Memory Review

Memory Health:
  MEMORY.md:        {{lines}}/200 lines ({{percent}}%)
  Topic files:      {{count}} ({{names}})
  CLAUDE.md:        {{lines}} lines
  Rules:            {{count}} files in .claude/rules/

🎯 Promotion Candidates ({{count}}):
  1. "{{pattern}}" — seen {{n}}x, applies broadly
     → Suggest: {{target}} (CLAUDE.md / .claude/rules/{{name}}.md)
  2. ...

🗑️ Stale Entries ({{count}}):
  1. Line {{n}}: "{{entry}}" — {{reason}}
  2. ...

🔄 Consolidation ({{count}} groups):
  1. Lines {{a}}, {{b}}, {{c}} all about {{topic}} → merge into 1 entry
  2. ...

⚠️ Conflicts ({{count}}):
  1. MEMORY.md line {{n}} contradicts CLAUDE.md: {{detail}}

💡 Recommendations:
  - {{actionable suggestion}}
  - {{actionable suggestion}}

When to Use

  • After completing a major feature or debugging session
  • When /si:status shows MEMORY.md is over 150 lines
  • Weekly during active development
  • Before starting a new project phase
  • After onboarding a new team member (review what Claude learned)

Tips

  • Run /si:review --quick frequently (low overhead)
  • Full review is most valuable when MEMORY.md is getting crowded
  • Act on promotion candidates promptly — they're proven patterns
  • Don't hesitate to delete stale entries — auto-memory will re-learn if needed