Self-Improving Agent — Development

This skill curates Claude Code's auto-memory into durable project knowledge. It analyzes MEMORY.md for patterns, promotes proven learnings to CLAUDE.md and .claude/rules/, and extracts recurring solutions into reusable skills.

engineering claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Analyzes MEMORY.md for promotion candidates, stale entries, and consolidation opportunities
Promotes patterns to CLAUDE.md or .claude/rules/
Extracts proven patterns into standalone skills
Provides memory health dashboard with line counts and recommendations
Explicitly saves important knowledge to auto-memory
Monitors command output for errors and captures structured entries

🎯 When to use it

Reviewing what Claude has learned about your project
Graduating a pattern from notes to enforced rules
Turning a debugging solution into a skill
Checking memory health and capacity

🚀 How to use

Trigger: /si:promote

Trigger via slash commands: /si:memory-review, /si:promote, /si:extract, /si:memory-status, /si:remember. Inputs: MEMORY.md and project context. Example prompts:

/si:memory-review
/si:promote <pattern>
/si:extract <pattern>

📄 Output: Analysis reports, promoted rules, extracted skills, and memory health dashboards.

📦 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/self-improving-agent .claude/skills/self-improving-agent

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

⚠️ Good to know

Requires Claude Code auto-memory (v2.1.32+) for full support; other platforms may have limited adaptation.

❓ FAQ

What is the difference between MEMORY.md and CLAUDE.md?

MEMORY.md is Claude's scratchpad with background context, while CLAUDE.md contains enforced instructions that load in full.

When should I use .claude/rules/ instead of CLAUDE.md?

Use .claude/rules/ for patterns that apply only to specific file types, so they load only when relevant files are open.

How does the error-capture hook work?

It monitors command output for errors and appends a structured entry to auto-memory with the command, error output, timestamp, and category, with zero token overhead on success.

🤖 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.