self-improving-agent · borghei — Claude Code skill: what it does, how to install
self-improving-agent — a skill for Claude Code, Codex, and Cursor that curates long-term agent memory. Converts repeated task outcomes into reviewed project rules.
LicenseRef-MIT-Commons-Clause 244 installs ★ 1,183 updated 2026-11-08
npx skills add borghei/Claude-Skills --skill self-improving-agent -a claude-codeWhat self-improving-agent does
Runs across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It monitors outcomes across development sessions, structures takeaways, and detects repeated patterns via pattern_extractor.py and feedback_analyzer.py.
The improvement cycle separates recording learnings, isolating recurring patterns, proposing rule updates, and auditing memory hygiene. Promoting an entry into CLAUDE.md or .claude/rules/ is strictly gated: rule_promoter.py tests recurrence criteria and waits for manual user approval before altering configuration.
Running the included tools requires Python 3. The rule_promoter.py script applies automated edits exclusively to section-based MEMORY.md files; index-based layouts pointing to standalone topic files require manual promotion.
What it helps with
- detect broken topic pointers and line bloat in MEMORY.md
- isolate recurring failure patterns from session logs
- stage verified guidelines before editing CLAUDE.md
- measure performance drops after updating rules
Example prompts for the agent
- Run a health audit on
./MEMORY.md - Extract recurring error patterns from
sessions.jsonl - Review promotion candidates for project rules
How to install self-improving-agent
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill self-improving-agent -a claude-code2Manually: put the files in place
~/.claude/skills/self-improving-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/self-improving-agent/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill self-improving-agent -a codex2Manually: put the files in place
.agents/skills/self-improving-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill self-improving-agent -a cursor2Manually: put the files in place
.cursor/skills/self-improving-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/self-improving-agent/SKILL.md2Manually: put the files in place
.github/skills/self-improving-agent/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill self-improving-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/self-improving-agentManually: put the files in place
.devin/skills/self-improving-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill self-improving-agent -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about self-improving-agent
How to install self-improving-agent in Claude Code?
Run npx skills add borghei/Claude-Skills --skill self-improving-agent -a claude-code in your terminal.
What does self-improving-agent do?
It reviews agent memory health, extracts repetitive lessons from logs, and guides promotion of proven behaviors into permanent instructions.
Can it promote rules without human review?
No, rules impact all future runs, so the promoter prints dry-run diffs and requires explicit confirmation before applying changes.
Similar skills
All skills for Agent setup: memory, context, orchestration →self-improving-agent by other authors comes first.