self-improvement

Installation
SKILL.md

Self-Improvement

This skill has two modes:

  1. 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.

  2. 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.

Passive Logging (Always Active)

Related skills

More from trtmn/agent-skills

Installs
22
First Seen
Mar 11, 2026