Self Improvement For All

Capture, store, and retrieve errors, corrections, and best practices locally to continuously improve AI agent workflows and knowledge.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install adaptive-learning-agents

Adaptive Learning Agent

Learn from errors and corrections in real-time. Continuously improve by capturing failures, user feedback, and successful patterns.

Free and open-source (MIT License) • Zero dependencies • Works locally

🚀 Why This Skill?

Problem Statement

Working with Claude or any AI agent means encountering:

Mistakes that need correction
Unexpected API behaviors
Better approaches discovered through experimentation
Knowledge gaps that get revealed during use

But there's no systematic way to learn from these moments and apply the knowledge next time.

The Solution

Adaptive Learning Agent captures every error, correction, and successful pattern automatically. Then retrieves relevant learnings before tackling similar problems again.

Real Use Cases

Bug discovery: Record an error once, never struggle with it again
Prompt optimization: Keep track of what prompt variations work best
API integration: Remember quirky behaviors and workarounds
Workflow improvement: Document shortcuts and best practices
Team knowledge: Export and share learnings across projects

✨ What You Get

Four Core Functions

1. Record Learnings

agent.record_learning(
    content="Use claude-sonnet for 90% of tasks—faster and cheaper",
    category="technique",
    context="Model selection"
)

Capture successful patterns, insights, and best practices.

2. Record Errors

agent.record_error(
    error_description="JSON parsing failed on null values",
    context="Processing API response",
    solution="Add null check before parsing"
)

Document failures and solutions automatically.

3. Search & Retrieve Learnings

results = agent.search_learnings("JSON parsing")
recent = agent.get_recent_learnings(limit=5)
by_category = agent.get_learnings_by_category("bug-fix")

Find relevant knowledge instantly when you need it.

4. View Summaries

summary = agent.get_learning_summary()
print(agent.format_learning_summary())

Understand what you've learned at a glance.

Key Features

✅ Zero dependencies - Pure Python, works everywhere ✅ Local-only storage - All data on your machine, no uploads ✅ MIT Licensed - Free to use, modify, fork, redistribute ✅ Automatic categorization - Errors become learnings ✅ Search and filter - Find knowledge by keyword or category ✅ Export capability - Share learnings as JSON ✅ No API keys - Works without any external credentials

📊 Real-World Example

from adaptive_learning_agent import AdaptiveLearningAgent

# Initialize agent
agent = AdaptiveLearningAgent()

# Day 1: Discover a bug
agent.record_error(
    error_description="Anthropic API rejects prompts with excessive newlines",
    context="Testing prompt with formatted lists",
    solution="Use \\n.strip() to clean whitespace before sending"
)

# Day 2: Same bug, but now you have the solution
similar_errors = agent.search_learnings("newlines")
# Result: [Previous learning with solution] ✅

# Week 1: Document successful pattern
agent.record_learning(
    content="Always use temperature=0 for deterministic output in tests",
    category="best-practice",
    context="Prompt engineering"
)

# Get weekly summary
summary = agent.get_learning_summary()
print(f"You've recorded {summary['total_learnings']} learnings this week!")
print(f"Resolved {summary['error_statistics']['resolved']} errors")

🔧 Installation

No installation needed! The skill is pure Python with zero dependencies.

# Copy the adaptive_learning_agent.py file to your project
# Or import it directly:

from adaptive_learning_agent import AdaptiveLearningAgent

💡 Use Cases

Software Development

Record bugs you find and their fixes. Next time you hit a similar error, you have the solution ready.

agent.record_error(
    error_description="Port 8000 already in use",
    context="Running local dev server",
    solution="Use `lsof -i :8000` to find process, then kill it"
)

Prompt Engineering

Keep track of prompting techniques that work for your specific use cases.

agent.record_learning(
    content="Chain-of-thought works better for math problems, direct answers for facts",
    category="technique"
)

API Integration

Remember quirky behaviors and workarounds for each provider.

agent.record_learning(
    content="OpenAI API requires explicit 'assistant' role messages",
    category="api-endpoint",
    context="Chat completion endpoint"
)

Team Knowledge

Export learnings and share with your team or future projects.

agent.export_learnings("team_learnings.json")
# Share this file with teammates

Continuous Improvement

Before major tasks, review what you've learned to avoid repeating mistakes.

summary = agent.get_learning_summary()
unresolved = summary['error_statistics']['unresolved']
if unresolved > 0:
    print(f"⚠️ {unresolved} unresolved errors—review before proceeding")

📚 Categories

When recording learnings, choose from these categories:

Category	Use For
technique	Working methods, approaches, strategies
bug-fix	Solutions to errors and problems
api-endpoint	API-specific behaviors and quirks
constraint	Limits, boundaries, restrictions
best-practice	Recommended patterns and standards
error-handling	How to handle specific types of errors

🎯 Sources

When recording learnings, specify the source:

user-correction - User told you something was wrong
error-discovery - You found the solution to an error
successful-pattern - You discovered something that works well
user-feedback - User suggested an improvement

📖 API Reference

Core Methods

`record_learning(content, category, source, context)`

Record a successful pattern or insight.

Parameters:

content (str, required): What was learned
category (str): One of the category types above
source (str): One of the source types above
context (str): Optional context about where this applies

Returns: Learning object with ID and timestamp

`record_error(error_description, context, solution, prevention_tip)`

Record an error and optionally its solution.

Parameters:

error_description (str, required): What went wrong
context (str, required): What was being attempted
solution (str): How to fix it
prevention_tip (str): How to avoid it

Returns: Error object with ID

`search_learnings(query)`

Search learnings by keyword or category.

Parameters:

query (str): Search term

Returns: List of matching Learning objects (sorted by relevance)

`get_recent_learnings(limit)`

Get the most recent learnings.

Parameters:

limit (int): Number to return (default: 10)

Returns: List of Learning objects, newest first

`get_learning_summary()`

Get comprehensive summary of learnings and errors.

Returns: Dictionary with statistics and recent items

`export_learnings(output_file)`

Export all learnings and errors to JSON file.

Parameters:

output_file (str): Path to save JSON (default: "learnings_export.json")

🔒 Privacy & Security

✅ Zero telemetry - No data sent anywhere
✅ Local-only storage - Everything stored in .adaptive_learning/ on your machine
✅ No API calls - Works completely offline
✅ No authentication - No accounts, keys, or logins needed
✅ Full transparency - Source code included and open-source

🤝 Contributing

This is MIT Licensed and community-maintained. You're encouraged to:

Fork the repository
Submit improvements and features
Integrate it into your projects
Share learnings with others

📝 Changelog

[1.0.0] - 2026-02-14

✨ Initial Release

Core learning system - Record and retrieve learnings
Error tracking - Capture errors with solutions
Search functionality - Find learnings by keyword or category
Local storage - All data stays on your machine
Export capability - Share learnings as JSON files
Zero dependencies - Pure Python, no external packages
MIT Licensed - Free to use, modify, redistribute
Comprehensive API - Simple, Pythonic interface

📞 Support

GitHub: https://github.com/clawhub-skills/adaptive-learning-agent
Issues & Contributions: Open an issue or PR on GitHub
Community: Share your learnings and improvements!

📄 License

MIT License - Free and open-source

Use, modify, fork, and redistribute freely. See LICENSE.md for full details.

Copyright © 2026 UnisAI Community

Last Updated: February 14, 2026 Current Version: 1.0.0 Status: Active & Community-Maintained

Free to use, modify, and fork. No restrictions.