self-improving-agent-v2

Record failures, discoveries, and optimizations in a local .learnings/ journal.

4|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Yog-Sotho/claude-skills --skill self-improving-agent-v2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-improving-agent-v2
Source: https://github.com/Yog-Sotho/claude-skills/tree/main/self-improving-agent-v2
Command: npx skills add https://github.com/Yog-Sotho/claude-skills --skill self-improving-agent-v2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The assistant often repeats mistakes and misses opportunities to improve; this skill provides a structured approach to record failures, discoveries, and optimizations so future tasks benefit from past learnings.

Core Features & Use Cases

  • Persistent learning notebook: create and maintain a private .learnings/ journal that captures high-signal entries after tasks.
  • Retrieval before solving similar tasks: automatically consult past learnings to inform approach and reduce repeat errors.
  • Safe, local storage and governance: strictly local storage with explicit safety rules to prevent leakage of sensitive data.

Quick Start

Enable the persistent learning store and begin recording a learning entry after completing a challenging task.

Frequently Asked Questions about self-improving-agent-v2

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stop my AI agent from repeating the same mistakes across different tasks?

To stop an agent from repeating mistakes, you need a persistent learning mechanism that records failures and corrections. This skill captures past errors and discoveries in a local `.learnings/` journal, automatically retrieving them to inform future solutions and prevent duplicate errors.

What is agent reflection and how does it improve task automation?

Agent reflection is the process of reviewing past actions to identify optimizations and failures. This skill implements reflection by storing high-signal learnings after tasks are completed, allowing the agent to apply these insights to future automation workflows and continuously improve performance.

How do I persist agent memory locally without leaking sensitive data?

You can persist agent memory locally by writing learnings to a private `.learnings/` directory. This skill enforces strict local storage with explicit safety rules, ensuring that recorded failures and optimizations remain private and preventing any leakage of sensitive data.

How do I build a self-improving agent that learns from past errors?

Building a self-improving agent requires recording discoveries and failures after they occur. This skill automatically consults past learnings before solving similar tasks, applying previous optimizations to reduce repeat errors and enabling the assistant to improve over time.

Does this agent memory skill work without external dependencies?

Yes, this agent memory skill operates without external dependencies. It uses strictly local storage to maintain the learning notebook, requiring no additional frameworks or APIs to record failures, retrieve past insights, and apply safety rules against data leakage.

When should I use a local learning journal for my AI assistant?

You should use a local learning journal when your assistant frequently misses opportunities to improve or repeats errors. It is especially valuable after corrections, failed tasks, or when a better approach emerges, allowing you to capture and reuse high-signal optimizations.