self-improve

Mine session episodes for friction patterns and propose evidence-backed instruction refinements.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/yiwei79/root-azoth --skill self-improve-yiwei79
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: self-improve
Source: https://github.com/yiwei79/root-azoth/tree/main/.opencode/skills/self-improve
Command: npx skills add https://github.com/yiwei79/root-azoth --skill self-improve-yiwei79

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agent workflows accumulate recurring friction and repeated failures that go unnoticed without a systematic review process. This Skill turns session episodes into structured reflexion and evidence-based proposals for improving skills and agent instructions over time. ## Core Features & Use Cases - L1 Reflexion Loop: Reflect on completed tasks, capture what worked and what failed, and record lessons as episodes in memory. - L2 Evidence-Based Refinement: Identify recurring patterns across 5+ episodes, root-cause them, generate A/B instruction variants, evaluate them against historical evidence, and propose the winner for human approval. - Governed Improvement Pipeline: Route approved proposals through an auto-composed pipeline with evidence review, ensuring no silent instruction changes and no kernel modifications. - Use Case: After several sessions show entropy alerts during auth module changes, mine the episodes, trace the cause to missing test-dependency discovery in the context-map skill, and propose a validated instruction fix. ## Quick Start Ask the agent to review recent session episodes for recurring friction and propose an evidence-backed improvement to the relevant skill instructions.

Frequently Asked Questions about self-improve

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

FAQPage Schema
How do I improve agent instructions based on past sessions?▼

Use the L2 refinement process: identify a recurring pattern in stored episodes, root-cause it, generate A/B instruction variants, evaluate them against historical evidence, and present the winning variant for human approval before applying.

What is the difference between L1 reflexion and L2 refinement?▼

L1 reflexion is in-context learning within a single session where the agent reflects and adjusts behavior immediately. L2 refinement is systematic instruction optimization based on evidence from 5 or more episodes, requiring human approval.

When should I run a self-improvement review?▼

Run it after session close, after repeated failures, after 5+ sessions provide enough data, or whenever friction is noticed. Explicit human requests to improve a process also trigger it.

Can self-improvement modify core kernel instructions automatically?▼

No. L2 refinement never modifies kernel instructions; kernel changes are handled at L3 through a separate governance pipeline. All L2 proposals require human approval and every variant is logged.

Why does an instruction refinement proposal get rejected?▼

Proposals fail when they lack supporting evidence, address a one-off issue rather than a pattern, or have no evaluation criteria to measure improvement. Subjective opinions without episode evidence are not accepted.