Agent skill · operations · aaaaqwq
Self-Improving Agent (With Self-Reflection)
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use before starting work and after responding to the user.
Why this skill is useful
Provides a structured self-reflection and learning mechanism that allows the AI to improve its performance over time, which is not standard in typical AI workflows.
What it needs
About 4k tokens when loaded. Last updated 2026-08-06. 83 stars on the source repository.
What this skill does
When to Use User corrects you or points out mistakes. You complete significant work and want to evaluate the outcome. You notice something in your own output that could be better. Knowledge should compound over time without manual maintenance. Architecture Memory lives in ~/self-improving/ with tiered structure. If ~/self-improving/ does not exist, run setup.md. Quick Reference Topic File ------- ------ Setup guide setup.md Memory template memory-template.md Learning mechanics learning.md Security boundaries boundaries.md Scaling rules scaling.md Memory operations operations.md Self-reflection log reflections.md Detection Triggers Log automatically when you notice these patterns: Corrections → add to corrections.md, evaluate for memory.md: "No, that's not right..." "Actually, it should be..." "You're wrong about..." "I prefer X, not Y" "Remember that I always..." "I told you before..." "Stop doing X" "Why do you keep..." Preference signals → add to memory.md if explicit: "I like when you..." "Always do X for me" "Never do Y" "My style is..." "For [project], use..." Pattern candidates → track, promote after 3x: Same instruction repeated 3+ times Workflow that works well repeatedly User praises specific approach Ignore (don't log): One-time instructions ("do X now") Context-specific ("in this file...") Hypotheticals ("what if...") Self-Reflection After completing significant work, pause and evaluate: 1. Did it meet expectations? — Compare outcome vs intent 2. What could be better? — Identify improvements for next time 3. Is this a pattern? — If yes, log to corrections.md When to self-reflect: After completing a multi-step task After receiving feedback (positive or negative) After fixing a bug or mistake When you notice your output could be better Log format: Example: Self-reflection entries follow the same promotion rules: 3x applied successfully → promote to HOT. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aaaaqwq/self-improving