scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/engineering-team/self-improving-agent
History
Exact
Reza Rezvani 84ec346e78 fix(self-improving-agent): remove broken relative hook paths from docs (#506) 
Issue #506 reported that `hooks/hooks.json` used `./hooks/error-capture.sh`
which fails for any session started outside the plugin dir. That specific
file was already fixed in commit 217b199 (which closed #392) — both
`hooks/hooks.json` and `settings.json` already use `${CLAUDE_PLUGIN_ROOT}`.

However, two stale example paths were still surfacing the bug in
documentation:

1. `engineering-team/self-improving-agent/CLAUDE.md` line 74 — "To enable"
   example with `./skills/self-improving-agent/hooks/error-capture.sh`
2. `engineering-team/self-improving-agent/hooks/error-capture.sh` header
   comment — install example with the same broken path

Both examples would teach users to copy the broken pattern into their own
settings.json, reproducing the exact bug #506 describes.

Fix: rewrite both examples to use `${CLAUDE_PLUGIN_ROOT}/hooks/error-capture.sh`
and add explicit "do not use relative paths" warnings. Also clarify in
CLAUDE.md that manual hook wiring is NOT needed when installing via
`/plugin install` — the hook is registered automatically from the plugin's
hooks.json.

Fixes #506

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 02:12:12 +02:00
..
.claude-plugin fix(self-improving-agent): register /si:* slash commands correctly (#505) 2026-04-11 02:09:10 +02:00
agents feat: add self-improving-agent plugin — auto-memory curation for Claude Code (#260) 2026-03-05 17:16:53 +01:00
hooks fix(self-improving-agent): remove broken relative hook paths from docs (#506) 2026-04-11 02:12:12 +02:00
reference feat: add self-improving-agent plugin — auto-memory curation for Claude Code (#260) 2026-03-05 17:16:53 +01:00
skills fix(self-improving-agent): register /si:* slash commands correctly (#505) 2026-04-11 02:09:10 +02:00
templates feat: add self-improving-agent plugin — auto-memory curation for Claude Code (#260) 2026-03-05 17:16:53 +01:00
CLAUDE.md fix(self-improving-agent): remove broken relative hook paths from docs (#506) 2026-04-11 02:12:12 +02:00
LICENSE feat: add self-improving-agent plugin — auto-memory curation for Claude Code (#260) 2026-03-05 17:16:53 +01:00
README.md feat: add self-improving-agent plugin — auto-memory curation for Claude Code (#260) 2026-03-05 17:16:53 +01:00
settings.json fix(self-improving-agent): use CLAUDE_PLUGIN_ROOT for hook paths 2026-03-25 09:32:57 +01:00
SKILL.md release: v2.1.1 — skill optimization, agents, commands, reference splits (#297) 2026-03-09 15:54:25 +01:00

README.md

Self-Improving Agent

Auto-memory captures. This plugin curates.

A Claude Code plugin that turns auto-memory into a structured self-improvement loop. Analyze what Claude has learned, promote proven patterns to enforced rules, and extract recurring solutions into reusable skills.

Why

Claude Code's auto-memory (v2.1.32+) automatically records project patterns in MEMORY.md. But it has no judgment about what to keep, what to promote, or when entries go stale. This plugin adds the intelligence layer.

The difference:

  • MEMORY.md: "I noticed this project uses pnpm" (background note, truncated at 200 lines)
  • CLAUDE.md: "Use pnpm, not npm" (enforced instruction, loaded in full)

Promoting a pattern from memory to rules fundamentally changes how Claude treats it.

Commands

Command What it does
/si:review Analyze auto-memory — find promotion candidates, stale entries, health metrics
/si:promote Graduate a pattern from MEMORY.md → CLAUDE.md or .claude/rules/
/si:extract Turn a recurring pattern into a standalone reusable skill
/si:status Memory health dashboard — line counts, capacity, recommendations
/si:remember Explicitly save important knowledge to auto-memory

Install

Claude Code

/plugin marketplace add alirezarezvani/claude-skills
/plugin install self-improving-agent@claude-code-skills

OpenClaw

clawhub install self-improving-agent

Codex CLI

./scripts/codex-install.sh --skill self-improving-agent

How It Works

Claude discovers pattern → auto-memory (MEMORY.md)
         ↓
Pattern recurs 2-3x → /si:review flags it
         ↓
You approve → /si:promote graduates it to CLAUDE.md
         ↓
Pattern becomes enforced rule, memory entry removed
         ↓
Space freed for new learnings

What's Included

Component Count Description
Skills 5 review, promote, extract, status, remember
Agents 2 memory-analyst, skill-extractor
Hooks 1 PostToolUse error capture (zero overhead on success)
Reference docs 3 memory architecture, promotion rules, rules directory patterns
Templates 2 rule template, skill template

Design Principles

  1. Don't fight auto-memory — orchestrate it. Auto-memory captures. This plugin curates.
  2. No duplicate storage. Reads from ~/.claude/projects/ directly. No .learnings/ directory.
  3. Zero capture overhead. Auto-memory handles capture. Hook only fires on errors.
  4. Promotion = graduation. Moving a pattern from MEMORY.md to CLAUDE.md changes its priority.
  5. Respect the 200-line limit. Actively manages MEMORY.md capacity.

Platform Support

Platform Memory System Support
Claude Code Auto-memory (MEMORY.md) ✅ Full
OpenClaw workspace/MEMORY.md ✅ Adapted
Codex CLI AGENTS.md ✅ Adapted
GitHub Copilot copilot-instructions.md ⚠️ Manual

Credits

Inspired by pskoett/self-improving-agent — a structured learning loop for AI coding agents. This plugin builds on that concept by integrating natively with Claude Code's auto-memory system.

License

MIT — see LICENSE