self-improving-agent

Record errors, corrections, and reusable learnings into structured Markdown logs.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/riipandi/minis-skills --skill self-improving-agent-riipandi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-improving-agent
Source: https://github.com/riipandi/minis-skills/tree/main/self-improving-agent
Command: npx skills add https://github.com/riipandi/minis-skills --skill self-improving-agent-riipandi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? AI agents repeat the same mistakes across sessions because failures, user corrections, and discovered best practices are never persisted. This Skill creates a traceable learning loop by logging errors, learnings, and feature requests to structured Markdown files, then promoting proven rules into long-term memory. ## Core Features & Use Cases - Structured Logging: Records errors (ERR), learnings (LRN), and feature requests (FEAT) with unique IDs, priorities, statuses, and metadata into LEARNINGS.md, ERRORS.md, and FEATURE_REQUESTS.md. - Scoped Storage & Promotion: Writes to a skill-level data directory by default, supports project-level .learnings/ scopes, and promotes cross-project entries to a public area with duplicate protection and automatic status back-writing. - Memory Integration: Defines hard criteria for promoting recurring patterns into the Minis memory system, including recurrence counting and pattern-key deduplication. - Use Case: After a curl command fails with HTTP 429 during a task, run the logging script to record the error with context; when the same issue recurs across projects, promote the entry so future sessions avoid the mistake. ## Quick Start Ask the agent to record the last command failure as an error entry using the self-improving-agent logging script.

Frequently Asked Questions about self-improving-agent

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

FAQPage Schema
How do I log an error or learning for an AI agent?

Run the minis_auto_log.sh script with the error, learning, or feature subcommand followed by a summary and details. Entries are appended to ERRORS.md, LEARNINGS.md, or FEATURE_REQUESTS.md with a unique ID, timestamp, priority, and status.

How do I promote a learning entry to long-term agent memory?

Use the promote subcommand with the entry ID to copy it to the skill's public area; the source entry is automatically marked as promoted. Promotion to Minis memory is recommended only when a rule recurs at least 3 times in 30 days or spans 2 different tasks.

Where are the learning log files stored by default?

By default, logs are written to /var/minis/skills/self-improving-agent/data/. You can override this with --project for project-level .learnings directories, --public for the shared public area, or --base for a custom path.

Does the script prevent duplicate promoted entries?

Yes. The promote command checks whether the entry ID already exists in the public area and exits without duplicating it. Entries already located in the public area are also skipped.

When should something not be recorded as a learning?

Casual chat, one-time trivial fixes, and details without reuse value should not be recorded. The skill also skips recording when the user explicitly says not to record.