self-improvement

Capture agent learnings and errors into structured markdown logs.

1|Updated May 20, 2026
One-click install
npx skills add https://github.com/Wanli-Lee/CUA-Claw-Harness --skill self-improvement-wanli-lee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-improvement
Source: https://github.com/Wanli-Lee/CUA-Claw-Harness/tree/main/skills/self-improving-agent-3.0.5
Command: npx skills add https://github.com/Wanli-Lee/CUA-Claw-Harness --skill self-improvement-wanli-lee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Reduces repeated errors and knowledge gaps by capturing what went wrong, what was corrected, and what worked for future reuse.

Core Features & Use Cases

  • Learning Capture & Categorization: Logs failures, user corrections, feature requests, knowledge gaps, and best practices into dedicated markdown files for later review.
  • Promotion to Workspace Memory: Promotes broadly applicable learnings into AGENTS.md, SOUL.md, TOOLS.md, and CLAUDE.md to improve consistency across sessions.
  • Automation Hooks Support: Uses provided activator and error-detector scripts to prompt evaluation after tasks and flag command failures for logging.

Quick Start

After you hit an unexpected failure or receive a correction, ask your agent to log it to .learnings/ using the self-improvement format, then review whether it should be promoted to AGENTS.md or TOOLS.md.

Frequently Asked Questions about self-improvement

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

FAQPage Schema
How do I capture agent errors and corrections for continuous improvement?

To capture agent errors and corrections for continuous improvement, log failures and user corrections into structured markdown files within a .learnings/ directory. This organizes knowledge gaps and best practices for future review and reuse.

What is workspace memory promotion for agent workflows?

Workspace memory promotion is the process of elevating broadly applicable learnings from local error logs into persistent workspace files like AGENTS.md, SOUL.md, and TOOLS.md to improve agent consistency across sessions.

Can I automate error logging when commands fail during coding sessions?

Yes, you can automate error logging when commands fail by using provided activator and error-detector scripts. These automation hooks flag command failures and prompt evaluation after tasks to ensure mistakes are logged.

What is the best way to track feature requests and knowledge gaps in markdown?

The best way to track feature requests and knowledge gaps in markdown is to use a deterministic logging format with YAML frontmatter. This routes entries into dedicated files like FEATURE_REQUESTS.md and ERRORS.md for structured review.

Why does my agent repeat mistakes despite having a .learnings directory?

Your agent repeats mistakes because local learnings are not automatically applied to future sessions. You must review the logs and promote broadly applicable corrections into workspace memory files like CLAUDE.md to ensure persistent behavioral changes.