How do I install the Self Improving Agent skill?

Run npx skillmds@latest add droodotfoo/self-improving-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Self Improving Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Self Improving Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Self Improving Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Self Improving Agent?

DROOdotFOO (@droodotfoo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Self Improving Agent by droodotfoo — Agent Skill

Name: Self Improving Agent
Author: DROOdotFOO

Self Improving Agent

Auto-curate memory, promote recurring patterns, and extract reusable knowledge across sessions. TRIGGER when: user says "/si:", asks about memory management, pattern promotion, or wants to review accumulated learnings. DO NOT TRIGGER when: user wants general code review, documentation, or project planning.

DROOdotFOO de5eb92 2 files · 6.7 KB Updated Sep 17, 2026

File contents

Self-Improving Agent

Curate session memory, promote recurring patterns to permanent config, and extract reusable skills.

Memory Stack

Three tiers, from most permanent to most ephemeral:

Repository guidance (you write) -- AGENTS.md in Codex or CLAUDE.md in Claude Code. Project-wide rules, preferences, and conventions that survive across sessions.
Review memory -- The host memory store, or a project MEMORY.md when the user has chosen a file-backed ledger. Observations, patterns, and corrections awaiting review.
Session Memory -- In-context learnings that exist only for the current session. Lost on exit unless promoted.

Commands

Command	Action
`review`	Scan the active review-memory source for promotion candidates. Show each with recurrence count and recommendation.
`promote`	Promote a pattern to AGENTS.md, CLAUDE.md, or an appropriate scoped rule. Remove it from review memory after promotion.
`extract`	Generate a complete skill from a recurring pattern (creates `skills/<name>/SKILL.md`).
`status`	Show memory stats: entries, staleness, promotion candidates, and session observations.
`remember`	Capture a specific observation with timestamp and context.

Invoke these as $self-improving-agent <command> in Codex, /si:<command> in Claude Code, or describe the operation in natural language.

Promotion Lifecycle

See promotion-lifecycle.md for detailed rules.

Summary: discover -> recurs 2-3x -> review flags -> promote to durable host guidance or a skill -> remove from review memory.

MEMORY.md Format

## Patterns

- [2026-04-01] Always use `--no-ff` for feature merges (seen 3x)
- [2026-04-03] Tests fail silently when DB not running -- add health check (seen 2x)

## Corrections

- [2026-04-02] User prefers `Result<T>` over panics in Rust (corrected 1x)

## Observations

- [2026-04-05] Build takes 4min -- investigate caching

What You Get

A curated MEMORY.md with timestamped patterns, corrections, and observations accumulated across sessions
Promotion recommendations identifying recurring patterns ready to graduate to AGENTS.md, CLAUDE.md, scoped rules, or a reusable skill
Extracted skills scaffolded from patterns that recur frequently enough to warrant standalone skill files

Rules

Never promote after a single occurrence -- wait for recurrence
Always show the user what will be promoted and where before writing
Remove promoted entries from MEMORY.md to prevent duplication
Timestamp every MEMORY.md entry
Capture error patterns automatically (see promotion-lifecycle.md for error-capture hook)

---name: self-improving-agentdescription: Auto-curate memory, promote recurring patterns, and extract reusable knowledge across sessions. TRIGGER when: user says "/si:", asks about memory management, pattern promotion, or wants to review accumulated learnings. DO NOT TRIGGER when: user wants general code review, documentation, or project planning.---# Self-Improving AgentCurate session memory, promote recurring patterns to permanent config, and extract reusable skills.## Memory StackThree tiers, from most permanent to most ephemeral:1. **Repository guidance** (you write) -- AGENTS.md in Codex or CLAUDE.md in Claude Code. Project-wide rules, preferences, and conventions that survive across sessions.2. **Review memory** -- The host memory store, or a project MEMORY.md when the user has chosen a file-backed ledger. Observations, patterns, and corrections awaiting review.3. **Session Memory** -- In-context learnings that exist only for the current session. Lost on exit unless promoted.## Commands| Command | Action ||---------|--------|| `review` | Scan the active review-memory source for promotion candidates. Show each with recurrence count and recommendation. || `promote` | Promote a pattern to AGENTS.md, CLAUDE.md, or an appropriate scoped rule. Remove it from review memory after promotion. || `extract` | Generate a complete skill from a recurring pattern (creates `skills/<name>/SKILL.md`). || `status` | Show memory stats: entries, staleness, promotion candidates, and session observations. || `remember` | Capture a specific observation with timestamp and context. |Invoke these as `$self-improving-agent <command>` in Codex, `/si:<command>` inClaude Code, or describe the operation in natural language.## Promotion LifecycleSee [promotion-lifecycle.md](./promotion-lifecycle.md) for detailed rules.Summary: discover -> recurs 2-3x -> review flags -> promote to durable host guidance or a skill -> remove from review memory.## MEMORY.md Format```markdown## Patterns- [2026-04-01] Always use `--no-ff` for feature merges (seen 3x)- [2026-04-03] Tests fail silently when DB not running -- add health check (seen 2x)## Corrections- [2026-04-02] User prefers `Result<T>` over panics in Rust (corrected 1x)## Observations- [2026-04-05] Build takes 4min -- investigate caching```## What You Get- A curated MEMORY.md with timestamped patterns, corrections, and observations accumulated across sessions- Promotion recommendations identifying recurring patterns ready to graduate to AGENTS.md, CLAUDE.md, scoped rules, or a reusable skill- Extracted skills scaffolded from patterns that recur frequently enough to warrant standalone skill files## Rules1. Never promote after a single occurrence -- wait for recurrence2. Always show the user what will be promoted and where before writing3. Remove promoted entries from MEMORY.md to prevent duplication4. Timestamp every MEMORY.md entry5. Capture error patterns automatically (see promotion-lifecycle.md for error-capture hook)

Frequently asked questions