Self Improvement For All

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.