Self-Improvement

This skill has two modes:

Passive logging (always active, no skill invocation needed) — Every error, correction, suggestion, or learning gets logged to ~/.learnings/ immediately as it happens. This is baked into Claude's behavior via CLAUDE.md and does not require triggering this skill.
Active review and promotion (triggered by /self-improvement) — Review accumulated learnings, promote valuable ones to CLAUDE.md, analyze GitHub PRs/issues, and do end-of-session retrospectives. Promotion only happens here, never automatically.

Log Files

Maintain three structured markdown files in ~/.learnings/ (create it if it doesn't exist):

~/.learnings/LEARNINGS.md — Corrections, knowledge gaps, best practices, suggestions
~/.learnings/ERRORS.md — Command failures, exceptions, unexpected behaviors
~/.learnings/FEATURE_REQUESTS.md — Capabilities the user asked for that you couldn't provide
~/.learnings/CHANGELOG.md — Permanent, append-only record of every promotion (and reversion) to CLAUDE.md
~/.learnings/ARCHIVE.md — All reviewed entries (promoted or skipped) move here. Not loaded into context unless the user explicitly asks to see it.