learnings

Capture agent corrections and score recurring mistakes for rule promotion.

3|1|Updated May 21, 2026
One-click install
npx skills add https://github.com/qwwiwi/agentos-skills-public --skill learnings-qwwiwi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learnings
Source: https://github.com/qwwiwi/agentos-skills-public/tree/main/skills/learnings
Command: npx skills add https://github.com/qwwiwi/agentos-skills-public --skill learnings-qwwiwi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Learnings System v2 helps you capture recurring errors and corrections, score them over time, and promote the best patterns into durable rules so the same failure modes don’t repeat.

Core Features & Use Cases

  • Episode capture from corrections: record an episode only when the owner explicitly corrected the agent or when a high-cost/recurring mistake is detected.
  • Scoring and prioritization: compute a composite score from recency, frequency, and impact to surface what matters most right now.
  • Promotion to rules: propose turning high-scoring learnings into updated rules/CLAUDE.md (owner-gated).
  • Linting, reporting, and maintenance: lint for hot/stale/promote/alert conditions and generate reports for review.

Quick Start

Ask the agent to record a correction episode and then run scoring and linting to produce a learning report for promotion or archival.

Frequently Asked Questions about learnings

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

FAQPage Schema
How do I capture and score recurring agent mistakes to prevent them in future sessions?

Agent self-improvement turns repeated mistakes into enforceable rules by capturing explicit corrections into an append-only episode store. A composite scoring model using recency, frequency, and impact surfaces what matters most for durable system updates.

How does error scoring and rule promotion work for ongoing workflow audits?

Error scoring calculates a composite score from recency, frequency, and impact to prioritize workflow audit findings. High-scoring learnings are proposed for owner-gated rule promotion to update system rules, while linting identifies hot, stale, or alert conditions.

What is the best way to track error patterns and agent corrections across multiple weeks?

Tracking error patterns across weeks requires an append-only episode store that records high-cost or recurring mistakes. This enables ongoing self-improvement by maintaining a durable learnings record accessible for linting and reporting across sessions.

Can I automatically update rules based on detected error patterns without manual review?

Rule promotion is owner-gated, so you cannot automatically update rules. The system proposes turning high-scoring learnings into updated rules or CLAUDE.md, but the owner must explicitly review and approve the promotion to ensure quality management.

How do I lint and generate reports for stale or hot learning episodes?

Linting checks for hot, stale, promote, and alert conditions within your episode store to identify maintenance needs. You can then generate reports from these linting results to review episodes for owner-gated rule promotion or archival.

When should I archive a learning episode instead of promoting it to a rule?

Archive a learning episode when it becomes stale or fails to meet promotion thresholds during linting. Episodes with low composite scores from recency, frequency, and impact are better archived than promoted to durable rules.