self-improvement

Captures learnings, errors, and corrections to enable continuous improvement across agent sessions.

pskoett 713 ↓ 8.6k updated 1mo ago
Claude Code
View source ↗

What it does

  • LEARNINGS.md — corrections, knowledge gaps, best practices
  • ERRORS.md — command failures, exceptions
  • FEATUREREQUESTS.md — user-requested capabilities
  • sessionslist — View active/recent sessions
  • sessionshistory — Read another session's transcript
  • sessionssend — Send a learning to another session
  • sessionsspawn — Spawn a sub-agent for background work

Requirements & configuration

  • | Tool gotchas | TOOLS.md | "Git push needs auth configured first" |
  • 2. Be specific - future agents need to understand quickly

Configuration: CLAUDEAGENTSTOOLSSOULLEARNINGSERRORSFEATURE_REQUESTSTYPE

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Captures learnings, errors, and corrections to enable continuous improvement across agent sessions.

Source

Repository: https://github.com/pskoett/self-improving-agent

self-improvement FAQ

What does the self-improvement skill do?

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks. LEARNINGS.md — corrections, knowledge gaps, best practices ERRORS.md — command failures, exceptions

What does self-improvement require?

| Tool gotchas | TOOLS.md | "Git push needs auth configured first" | 2. Be specific - future agents need to understand quickly Configuration keys: CLAUDE, AGENTS, TOOLS, SOUL, LEARNINGS, ERRORS, FEATURE_REQUESTS, TYPE.

How do I install self-improvement?

Run: npx -y skills add https://github.com/pskoett/self-improving-agent --skill self-improvement --agent claude-code — the source lives at github.com/pskoett/self-improving-agent.

Maintain self-improvement?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

self-improvement on getagentictools
[![self-improvement on getagentictools](https://getagentictools.com/badge/skills/pskoett-self-improving-agent-self-improvement.svg)](https://getagentictools.com/skills/pskoett-self-improving-agent-self-improvement?ref=badge)
npx agentictools info skills/pskoett-self-improving-agent-self-improvement

The second line is the CLI lookup for this page — handy in READMEs and docs.